VS Code中Go代码自动格式化需同时满足三条件：goimports已安装并可执行、项目含go.mod且工作区打开其根目录、设置中"go.formatTool":"goimports"且"[go]": {"editor.formatOnSave":true}。
gofmt 不是 VS Code 插件，它只是 Go 自带的命令行工具；VS Code 里真正起作用的是官方 golang.go 扩展，它调用 gofmt、goimports 或 gopls 来完成格式化。直接搜“Gofmt 插件”容易走偏——你不需要装额外插件，只需要配对工具链和设置。
确认 goimports 是否已安装并可执行
VS Code 的 Go 扩展默认倾向使用 goimports（而非裸 gofmt），但它不会帮你装这个二进制。不装，保存时就静默失败，连报错都不给。
- 终端运行
goimports -version，若提示command not found，说明没装 - 正确安装命令：
go install golang.org/x/tools/cmd/goimports@latest（Go 1.21+ 必须带@latest） - 装完检查
$GOPATH/bin是否在$PATH中：运行go env GOPATH查路径，再确认该路径下的goimports可被 shell 直接调用
必须用 [go] 语言专属配置，不能只设全局 formatOnSave
VS Code 对不同语言的格式化行为由语言作用域控制。editor.formatOnSave: true 设成全局，对 .go 文件无效——这是最常被忽略的配置层级问题。
- 打开
settings.json（命令面板 →Preferences: Open Settings (JSON)） - 写入以下块（不是平铺在顶层，而是作为独立语言配置项）：
"[go]": { "editor.formatOnSave": true, "editor.defaultFormatter": "golang.go", "go.formatTool": "goimports" } -
go.formatTool值必须是字符串"goimports"（带双引号），设成gofmt会导致 import 不自动管理，且可能与goimports冲突
项目根目录必须含 go.mod，且 VS Code 工作区要打开该目录
goimports 依赖 go.mod 推断模块边界和本地包路径。没有它，工具会跳过 import 处理，甚至完全不触发格式化——但 VS Code 不报错，只“不动”。
- 在项目根目录运行
go mod init example.com/myproject生成go.mod - VS Code 必须通过
File → Open Folder…打开**含go.mod的文件夹**，不能只打开单个.go文件或子目录 - 若用
goimports -local分组本地导入，需确保go.mod中的 module 名与-local参数一致（如goimports -local example.com）
验证是否真在调用 goimports，而不是卡在某环
右下角状态栏显示 “Formatting with Go” 一闪而过 ≠ 成功。它只表示 VS Code 把保存事件发出去了，不保证 goimports 执行成功。
立即学习“go语言免费学习笔记（深入）”；
- 临时在终端跑
goimports -l .：如果有输出文件名，说明有未格式化代码；无输出才代表当前合规 - 手动触发格式化：右键 →
Format Document With…→ 看默认项是不是Go；若显示None，说明defaultFormatter配置未生效或扩展未加载 - 重启 VS Code（不是重载窗口），尤其在改完
go.formatTool或装完工具后——很多失效问题靠重启解决
go.mod 被识别为模块根、VS Code 把保存动作准确传给了那个二进制。缺一不可。 
