gofmt 是 Go 官方代码格式化工具，仅按官方风格重排源码；它本身不是编辑器插件，不监听保存事件，自动格式化需依赖编辑器（如 VS Code 配合 Go 扩展）调用，且需正确配置 PATH、formatOnSave 及 formatTool。
gofmt 是什么，为什么不能用它自动保存时格式化？
gofmt 是 Go 官方提供的代码格式化工具，它只做一件事：把 Go 源码按官方风格重排（缩进、括号、空行、操作符前后空格等）。但它本身**不是编辑器插件，也不监听文件保存事件**。所谓“自动格式化”，实际是编辑器/IDE 调用 gofmt（或更现代的 go fmt）命令完成的。直接运行 gofmt -w main.go 会写回文件，但没人会手动敲这条命令。
VS Code 中启用保存时自动格式化（Go 扩展必需）
VS Code 默认不识别 Go 文件的格式化逻辑，必须安装官方 golang.go 扩展（由 Go 团队维护）。装好后还需确认以下几点：
- 确保
go命令在系统 PATH 中（终端执行go version能返回结果） - VS Code 设置中开启：
"editor.formatOnSave": true - Go 扩展默认使用
gofmt；如需改用goimports（自动管理 import），需额外配置："go.formatTool": "goimports"
（前提是已安装：go install golang.org/x/tools/cmd/goimports@latest） - 若保存后无反应，检查右下角状态栏是否显示 “Go” 并有格式化图标；点击可手动触发，失败时会弹出错误提示（常见于
GOROOT或GOBIN路径未正确设置）
命令行直接使用 gofmt 的典型场景和参数差异
日常开发中，gofmt 主要用于批量检查或 CI 流水线验证，而不是逐个文件手调。关键参数含义如下：
-
gofmt -l .：列出所有**未格式化**的 Go 文件路径（不修改内容），适合做 pre-commit 检查 -
gofmt -w .：递归格式化当前目录下所有.go文件（含子目录），等价于go fmt ./... -
gofmt -s：启用简化模式（例如把if v, ok := m[k]; ok { ... }合并为if v, ok := m[k]; ok { ... }—— 实际上这个例子不会变，但-s会合并某些冗余 if/for 结构） -
gofmt -d file.go：输出格式化前后的 diff，适合调试或确认变更范围
注意：gofmt 不处理 import 排序或自动增删 import，那是 goimports 或 gopls 的职责。
立即学习“go语言免费学习笔记（深入）”；
gofmt 和 gofmt -r 的安全边界在哪？
gofmt -r 支持简单 AST 级替换（如 gofmt -r "a + b -> b + a" *.go），但它**不是通用代码重构工具**，且极易误伤：
- 匹配基于语法结构，不是字符串；
a + b只匹配顶层二元加法表达式，不匹配func() int { return a + b }内部的a + b - 没有作用域感知，无法区分变量名、字段名、函数名；
-r "io.Read -> io.ReadFull"可能错误替换注释或字符串字面量 - Go 1.22+ 已明确标记
-r为“实验性”，不建议在自动化流程中使用
真正需要安全重构，请用 gopls 提供的 rename / extract 等语义操作，或专用工具如 gomodifytags 处理 struct tag。
