.editorconfig 在 go 项目中易失效，因 go 插件（如 vs code 的 golang.go、goland）默认禁用它以防与 gofmt 冲突；需手动开启支持，且仅应配置 indent_style = tab 和 tab_width = 4，避免 indent_size 等无效字段。
为什么 .editorconfig 在 Go 项目里容易失效
Go 社区默认用 gofmt（或 goimports）统一格式，编辑器的 .editorconfig 规则常被忽略——不是配置写错了，而是 Go 插件主动禁用了它。VS Code 的 golang.go 扩展、GoLand 默认关掉 EditorConfig 对 .go 文件的支持，因为担心和 gofmt 冲突。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 确认编辑器是否真在读取
.editorconfig：在 VS Code 中打开任意.go文件，按Ctrl+Shift+P（或Cmd+Shift+P），搜 “EditorConfig: Show Current Rules”，看输出里有没有indent_style等字段生效 - VS Code 用户必须在
settings.json里显式开启："editorconfig.editorconfig.enableForGo": true
- GoLand 用户需勾选
Settings > Editor > Code Style > Go > Enable EditorConfig support - 别在
.editorconfig里配indent_size = 4—— Go 官方强制用 Tab 缩进，gofmt会无视空格缩进并自动转成 Tab
indent_style 和 indent_size 在 Go 里怎么设才不打架
Go 的缩进语义是「Tab 字符 + 一个 Tab = 8 个空格宽度」，但显示时多数编辑器默认把 Tab 渲染为 4 列。这里的关键不是“多宽”，而是“用什么字符”。gofmt 只接受 Tab，且不认 indent_size 的数值。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
-
.editorconfig中只写：indent_style = tab<br>tab_width = 4
（tab_width仅控制显示宽度，不影响gofmt输出） - 不要写
indent_size = 4—— 这个字段对 Tab 缩进无效，且部分编辑器会误判为“要插 4 个空格” - 如果团队混用 Vim / Neovim，记得在
.vimrc里加：autocmd FileType go setlocal expandtab! softtabstop=-1
，确保不把 Tab 转成空格 - 验证方式：保存一个
.go文件后，用xxd main.go | head -n 5看缩进位置是不是09（Tab 的十六进制）
哪些 Go 特有场景必须靠 .editorconfig 补位
gofmt 不管文件编码、行尾、空行、最大行宽，也不处理非 .go 文件（比如 go.mod、Dockerfile、测试用的 .json）。这些恰恰是跨编辑器协作最容易出乱码或 Git 脏 diff 的地方。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 在
.editorconfig顶层写通用规则：root = true<br>*<br>end_of_line = lf<br>charset = utf-8<br>trim_trailing_whitespace = true<br>insert_final_newline = true
- 单独为 Go 相关非源码文件加规则：
[go.mod]<br>indent_style = tab<br><br>[Dockerfile]<br>indent_style = space<br>indent_size = 2<br><br>[*.json]<br>indent_style = space<br>indent_size = 2
- 避免
max_line_length：Go 社区不强制单行长度，golint已废弃，revive等工具用独立配置，EditorConfig 不该越界管这事
CI 里要不要校验 .editorconfig 生效
不用。EditorConfig 是编辑器本地行为，CI 没法、也不该去断言“某人用了 Tab 而不是空格”。真正该进 CI 的是格式一致性本身——也就是 gofmt -l 和 go vet。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- CI 脚本里只跑：
gofmt -l . | grep -q "." && echo "format error" && exit 1 || true
- 如果想间接验证 EditorConfig 是否被团队成员启用，可以在 PR 模板里加一句：
请确认你的编辑器已加载 .editorconfig（尤其检查 go 文件是否用 Tab 缩进）
- 最易被忽略的点：Windows 用户可能默认用 CRLF，
.editorconfig的end_of_line = lf能防 Git 提示 “CRLF will be replaced by LF”，但前提是 Git 配置没开core.autocrlf = true—— 这个比 EditorConfig 优先级更高
