推荐用 go fmt 而非 gofmt，因其自动识别模块路径、支持 -w 写入且与 go mod 集成更稳；goimports 是 go fmt 的超集，额外提供 import 增删、分组、排序功能，应优先配置为编辑器默认格式工具。
直接用 go fmt 或 goimports，别自己调 gofmt 二进制——它不识别模块路径，容易在多模块项目里漏格式化、错排 import，甚至因 Go 版本不匹配导致泛型对齐失效。
go fmt 和 gofmt 到底该用哪个？
go fmt 是 Go 工具链封装的命令，自动按当前模块路径解析包，支持 -w 写入且与 go mod 行为一致；gofmt 是底层程序，只认文件路径，不感知模块，也不处理 replace 或 vendor 下的导入逻辑。
- 日常开发一律用
go fmt -w ./，不是gofmt -w ./ - 检查未格式化文件：用
go fmt -l ./，CI 中失败即阻断 - 执行
gofmt不带参数会卡住——它在等 stdin 输入，不是 bug - 验证是否生效：改一个
import顺序，保存后看是否自动重排
为什么推荐 goimports 而不是 go fmt？
go fmt 只做语法结构标准化（缩进、括号、空格），完全不管 import 语句；goimports 是它的超集，额外完成 import 的增删、分组（标准库 / 第三方 / 本地）、字母排序，且默认兼容所有 go fmt 行为。
- 安装命令必须是
go install golang.org/x/tools/cmd/goimports@latest，不是go get - 确保
$GOBIN或$GOPATH/bin在PATH中，否则 VS Code/Goland 找不到 - VS Code 设置里把
go.formatTool明确设为"goimports"，别依赖默认值 - GoLand 需手动勾选 “Run
goimports”（Settings → Languages & Frameworks → Go → Formatting）
gofumpt 能不能直接替代 goimports？
可以，但要清楚代价：gofumpt 是风格更严格的增强版，禁用 -s 简化规则（比如不会把 if err != nil { return err } 合并成一行），且不管理 import 分组——它和 goimports 功能不重叠，也不能互相替代。
- 若要用
gofumpt，得搭配goimports一起用（例如 VS Code 中用goimports格式化 + 整理 import，再用gofumpt做二次风格收紧） - CI 中若只跑
gofumpt -l，可能漏掉 import 错误，必须补上goimports -l -
.editorconfig对 Go 文件基本无效——缩进、换行全由格式器强制决定，只留[*.go]告诉编辑器这是 Go 文件即可
真正容易被忽略的是模块根目录识别：非 go.mod 所在目录下运行 goimports，它可能无法正确解析本地包路径，导致 import 错乱。格式化前先 cd 进模块根，比配一堆路径变量更可靠。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
