Go语言如何格式化代码_Go语言gofmt代码格式化教程【详解】

gofmt从来就不是让你选风格的——它只做一件事：按 Go 官方约定重排代码。缩进宽度、空行数量、括号位置，这些统统改不了，它不接受任何个性化配置。

gofmt 不是用来选风格的，它只做一件事：按 Go 官方约定重排代码。你改不了缩进宽度、空行数量、括号位置——它不接受任何个性化配置。

gofmt -w 是日常唯一需要记住的命令

不加 -w，gofmt 只把格式化后的内容打印到终端，文件本身完全没变。很多人以为“看到整齐输出=已格式化”，结果提交的仍是脏代码。

• gofmt -w main.go：格式化单个文件并写回
• gofmt -w ./：格式化当前模块下所有 .go 文件（注意是 ./，不是 . 或空格）
• gofmt -d ./：预览差异，不写入，适合 CI 或人工确认前检查
• 如果报错 no Go files in，大概率是当前目录没有 go.mod，或路径写错了，比如误输成 .\

VS Code 里保存没反应？先看 go.formatTool 调用的是谁

VS Code 的 Go 扩展默认启用 gopls，它的格式化行为优先级高于独立 gofmt，且支持更细粒度控制（比如长参数是否换行）。但如果你手动改过设置，可能已退回到原始 gofmt。

• 打开设置，搜索 go.formatTool，确认值是 gopls（推荐）或 goimports，而不是 gofmt
• 运行 go env GOPATH，确认 gopls 在 $GOPATH/bin 下可执行
• gopls 默认跳过 _test.go 中的 ExampleXXX 函数——这是设计如此，不是 bug

gofmt 和 goimports 别混着用

goimports 是 gofmt 的超集：它会格式化 + 自动增删 import。两者直接混用会导致 import 被反复添加又删除，尤其在团队协作中容易引发无意义的 diff。

• 装 goimports：go install golang.org/x/tools/cmd/goimports@latest
• VS Code 中把 go.formatTool 设为 goimports，重启编辑器
• goimports 要求项目含 go.mod；Go 1.21 之前的旧结构（无 go.mod）会静默失败，不报错也不生效

别用 gofmt -r 做重构

gofmt -r 支持自定义重写规则（如 gofmt -r '(a) -> a' -w *.go），但它没有语法树校验、不保证安全、出错后无法回滚。

• 常见错误：规则写错导致合法代码被破坏（比如误删必要括号）
• 没有 IDE 支持，不能预览变更范围
• 现代替代方案更可靠：用 gopls 的重命名/提取函数功能，或 gofumpt（仅限个人项目，非官方，团队慎用）

真正卡住人的从来不是不会敲命令，而是搞不清编辑器底层调用的是哪个工具、有没有真正执行、以及 go.mod 是否存在——这三处一错，格式化就形同虚设。