VSCode中Go代码不格式化，主因是goimports未安装或未加入PATH、go.mod缺失、VSCode未以文件夹形式打开含go.mod的项目根目录，以及设置未在[go]语言专属块中配置editor.formatOnSave和go.formatTool为"goimports"。
VSCode 里 Go 代码不格式化，大概率不是编辑器坏了，而是 goimports 没装上、go.mod 缺失，或系统/编辑器编码没对齐 —— 尤其是 Windows 下的 UTF-8 终端乱码常被误判为格式化失败。
goimports 命令找不到？别只装 gofmt
VSCode 的 Go 扩展默认调用 goimports（不是裸 gofmt），它负责格式化 + 自动管理 import。但扩展不会自动安装它。
- 终端运行
goimports -version，报command not found就说明没装 - 正确安装命令：
go install golang.org/x/tools/cmd/goimports@latest（Go 1.21+ 必须带@latest） - 装完检查：
go env GOPATH查路径，再确认$GOPATH/bin（Windows 是%GOPATH%\bin）是否在PATH中 —— VSCode 启动时读的是系统 PATH，不是你终端里临时改的 - 如果已装但 VSCode 还找不到，重启 VSCode（不是重载窗口），让它重新读取环境变量
VSCode 设置必须用 [go] 语言专属块
全局开启 editor.formatOnSave 对 .go 文件完全无效。Go 扩展只认语言作用域配置。
- 打开
settings.json（命令面板 → Preferences: Open Settings (JSON)） - 写入以下结构（不是平铺在顶层）：
"[go]": {
"editor.formatOnSave": true,
"editor.defaultFormatter": "golang.go",
"go.formatTool": "goimports"
}
-
go.formatTool必须是字符串"goimports"，设成"gofmt"会导致 import 不清理、格式化行为不一致 - 不要在用户设置里写
"[go]": { ... }，而要确保它在工作区设置或用户设置的 JSON 根对象内，且是独立 key
go.mod 缺失或工作区没开对根目录
goimports 依赖 go.mod 推断模块边界和本地包路径。没有它，工具会静默跳过格式化 —— 不报错、不动文件、也不提示。
立即学习“go语言免费学习笔记（深入）”；
- 项目根目录下运行
go mod init example.com/myproject生成go.mod - VSCode 必须通过
File → Open Folder…打开**含go.mod的文件夹**，不能只打开单个.go文件，也不能打开子目录 - 如果项目有多个模块，确保当前打开的文件夹对应一个完整模块（即有且仅有一个
go.mod）
Windows 下 UTF-8 编码冲突导致“格式化失败”假象
有时保存后代码看似没变，或者终端输出中文变乱码，你以为是格式化没生效，其实是文件编码或终端环境没对齐。
- VSCode 右下角点击编码状态（如 “UTF-8”），选 “Save with Encoding” → “UTF-8”，强制保存为 UTF-8
- Windows 终端（CMD/PowerShell）需启用 UTF-8：运行
chcp 65001；更稳妥的是在 PowerShell 设置中勾选 “使用旧版控制台” 或升级到 Windows Terminal - Vim 用户注意：
tenc（terminal encoding）必须设为utf-8，否则即使文件是 UTF-8，Vim 在终端里读写时也会二次转码出错 -
.editorconfig对 Go 格式基本无效 ——gofmt和goimports强制用 tab 缩进、忽略空格配置，别白配
真正卡住的地方往往就三处：goimports 没装进 PATH、settings.json 里没写 [go] 块、项目没 go.mod 或 VSCode 没开对目录。其他都是干扰项。
