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，只看这个配置项：

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

• 打开设置（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 很可能假装成功，实际什么都没做。