推荐使用 go fmt 而非 gofmt，因其自动识别模块路径、支持 -w 写入且与 go mod 集成更稳；gofumpt 是增强替代品，需显式配置编辑器和 CI；.editorconfig 对 Go 格式无效。
用 gofmt 还是 go fmt？别混淆命令本质
gofmt 是底层格式化程序，go fmt 是 Go 工具链封装的调用方式，二者默认行为一致，但参数支持不同。日常开发推荐直接用 go fmt，它自动识别模块路径、支持 -w 写入文件，且与 go mod 集成更稳。
常见错误：手动下载并全局替换 gofmt 二进制，结果和 go 版本不匹配，导致格式化结果异常（比如 Go 1.22 新增的泛型对齐规则不生效）。
- 检查当前生效版本：
go version和go fmt -h输出的 usage 是否含-s（简化代码）选项 - 想批量格式化整个模块：运行
go fmt ./...，不是gofmt -w ./... - 编辑器里配置时，确认调用的是
go fmt而非独立gofmt，VS Code 的golang.go扩展默认走前者
启用 gofumpt 替代默认格式器的实操要点
Go 官方 go fmt 不支持自定义风格（如强制空行、函数括号换行），gofumpt 是社区广泛接受的增强替代品，它保持兼容性的同时收紧规则。
关键动作不是“安装就完事”，而是让工具链真正切换过去：
立即学习“go语言免费学习笔记（深入）”；
- 安装：
go install mvdan.cc/gofumpt@latest（注意不是go get） - VS Code 中，在设置里搜
go.formatTool，设为"gofumpt"；若用 Goland，需在 Settings → Tools → File Watchers 中把go fmt替换为gofumpt命令 - CI 中若用
gofumports（旧名），要统一升级，否则gofumpt -l检查失败但本地没报错 -
gofumpt默认禁用-s简化，如需保留（例如合并if err != nil { return err }为一行），得显式加-s参数
.editorconfig 对 Go 文件基本无效，别白配
Go 的缩进、换行、空格由 go fmt 或 gofumpt 强制决定，.editorconfig 里的 indent_style、tab_width 等设置在保存时会被覆盖。唯一有用的是告诉编辑器“这是 Go 文件”，避免误用 JS 或 Python 规则。
可保留的最小配置：
[*.go] indent_style = tab indent_size = 4 end_of_line = lf insert_final_newline = true
但注意：indent_style 和 indent_size 实际不起作用——Go 格式器只认 tab 缩进，且不关心 tab 显示为几个空格；真正起效的是编辑器的 “Format on Save” 是否调用 Go 格式命令。
Git 提交前自动格式化的可靠写法
用 pre-commit 或 husky 做 Go 格式检查容易翻车，因为它们默认执行的是 shell 命令，而 go fmt 在子目录下运行时可能找不到 go.mod，报 no Go files in directory。
- 推荐方案：用
git config core.hooksPath .githooks，然后在.githooks/pre-commit中写： #!/bin/shgo fmt $(git diff --cached --name-only --diff-filter=ACM | grep '\.go$') || exit 1- 更稳妥的做法是先定位模块根目录：
cd $(git rev-parse --show-toplevel) && go fmt ./... - 别用
goimports替代go fmt做 pre-commit 主格式器——它会修改 import 分组，可能引发意外交互（如重排标准库/第三方包顺序导致 diff 噪声）
真正的麻烦点不在命令本身，而在团队成员是否都启用了 hook，以及 CI 是否复用同一套检查逻辑。最省心的方式是 CI 里跑 go fmt -l ./... 并设为失败项，本地靠编辑器自动格式，不强依赖 pre-commit。
