VS Code 保存 Go 文件未自动格式化，大概率是 go.formatTool 未设为 "goimports"、goimports 未正确安装或缺失 go.mod 文件；三者任一出错，其余配置均无效。
VS Code 保存 Go 文件时没自动格式化，大概率是 go.formatTool 没设对、goimports 没装好，或项目缺 go.mod——这三处一错，其他设置全白搭。
确认 goimports 是否已安装并可用
VS Code 的 Go 扩展默认调用 goimports（而非原始 gofmt），但它不会帮你装工具本身。
- 终端运行
goimports -version；若报command not found，说明没装 - 正确安装命令：
go install golang.org/x/tools/cmd/goimports@latest - 装完后检查
$GOPATH/bin是否在$PATH中（可运行go env GOPATH查路径） - Go 1.21+ 必须用
@latest后缀；旧版用@master可能失效
检查 VS Code 设置里的 formatTool 值
编辑器是否真在调用 goimports，只看这个配置项：
- 打开设置（
Ctrl+,或Cmd+,），搜go.formatTool - 值必须是
"goimports"（字符串，带英文双引号）；"gopls"也可行，但本质仍是它内部调用goimports - 绝对不要设成
"gofmt"—— 否则 import 不会自动增删，且和goimports冲突 - 如果改过设置但没生效，重启 VS Code（不是重载窗口）
确保项目含 go.mod 且路径正确
goimports 默认依赖 go.mod 推断模块边界；没有它，可能静默失败，不报错也不格式化。
- 运行
go mod init example.com/myproject（随便起个模块名）生成go.mod - VS Code 工作区必须打开的是模块根目录（即含
go.mod的文件夹），不能只开子目录 - 若用
goimports -local分组本地包，需确保模块路径与-local参数一致（如goimports -local example.com） -
gofmt -w ./能跑 ≠goimports -w ./能跑——前者不依赖go.mod，后者强依赖
验证 formatOnSave 是否真正触发
即使上面都对了，也可能因配置层级被覆盖而失效。
- 检查设置中
editor.formatOnSave是true（全局或工作区级别） - 在
.vscode/settings.json中显式写入更可靠：{ "editor.formatOnSave": true, "go.formatTool": "goimports" } - 保存后观察右下角状态栏：若显示 “Formatting with Go” 一闪而过，说明调用成功；若无反应，大概率是
goimports执行出错（比如权限/路径/模块问题） - 临时在终端手动跑
goimports -l .，如果有输出文件名，说明有未格式化代码；无输出则表示当前已合规
真正卡住人的从来不是选项在哪点，而是 goimports 是否真在运行、它能否识别当前模块、以及编辑器有没有把保存事件传给它——这三环缺一不可。尤其注意 go.mod 缺失时，VS Code 很可能假装成功，实际什么都没做。
