gofmt是Go官方内置的不可配置格式化工具，安装Go后即存在$GOROOT/bin/gofmt，需确保其路径加入$PATH；VS Code中自动格式化依赖gopls调用goimports（而非纯gofmt），须安装goimports、配置"[go]": {"editor.formatOnSave": true}并设"go.formatTool":"goimports"。
确认 gofmt 已就绪且路径正确
装完 Go 后 gofmt 就在 $GOROOT/bin/gofmt，但不是所有终端都能直接调用它。常见问题是 command not found，本质是 $GOROOT/bin 没进 $PATH。
- 运行
go version确认 Go 可用；再跑which gofmt，输出应类似/usr/local/go/bin/gofmt（macOS/Linux）或C:\Go\bin\gofmt.exe（Windows） - 若返回空，检查 shell 配置文件（
~/.zshrc或~/.bash_profile）是否含export PATH=$PATH:$GOROOT/bin，然后source它 - 别依赖
/usr/local/bin/gofmt这类手动软链——它可能指向旧版或第三方 fork，和go命令版本不一致
VS Code 保存时自动格式化失效的排查点
VS Code 的 Go 扩展（golang.go）默认用 gopls 提供格式化，而 gopls 默认调用的是 goimports（含 gofmt 功能 + 导入管理），不是纯 gofmt。保存没反应，多半是配置被覆盖或工具缺失。
-
"go.formatTool"字段已弃用，设了也无效；真正起作用的是gopls的行为，它优先找goimports - 确保已安装
goimports：go install golang.org/x/tools/cmd/goimports@latest；否则gopls会退回到基础gofmt，但部分场景仍失败 - 检查设置里
"editor.formatOnSave": true和"[go]": { "editor.formatOnSave": true }是否同时存在，后者不能被 workspace 设置屏蔽 - 右下角状态栏点 “Go” 图标，手动触发格式化——失败时弹窗会暴露真实错误，比如
GOBIN路径不对或goimports找不到
命令行批量格式化必须用 gofmt -w .，不是 gofmt -w *.go
gofmt -w *.go 只处理当前目录下的 .go 文件，漏掉子目录、vendor/、嵌套模块，还可能因 shell 展开失败（如文件名含空格）出错。正确做法是以 module root 为起点递归处理。
- cd 进含
go.mod的目录，执行gofmt -w .—— 它会自动识别整个 module 下所有 Go 文件 - 想预览改动？去掉
-w：gofmt .，输出 diff 到终端；加-l：gofmt -l .只列出未格式化的文件路径，适合 pre-commit 钩子 -
gofmt没有--exclude参数；真要跳过某些目录（如internal/testdata），得用find . -name "*.go" ! -path "./internal/testdata/*" | xargs gofmt -w，但容易漏文件，不推荐常规使用 - 注意：
gofmt不管 import，那是goimports或gopls的事；如果发现 import 没排序，说明你没配好goimports或gopls没生效
gofmt -r 是危险操作，别当重构工具用
gofmt -r 支持 AST 级替换（如 gofmt -r "log.Print -> log.Println" *.go），但它没有作用域分析、不区分注释/字符串、也不校验语义，极易误改。
立即学习“go语言免费学习笔记（深入）”；
- 匹配基于语法结构，不是文本：
a + b只匹配顶层表达式，不会动return a + b里的a + b - 字符串字面量、注释里的内容也会被替换，比如
// handle a + b error会被改成// handle b + a error - CI/CD 或团队规范里禁止用
-r；日常开发中，该功能只用于极少数明确可控的脚本场景，且必须先gofmt -d预览 diff - 需要安全重构？用
gopls的 rename 功能或专用工具（如gomodifytags），它们有类型信息支撑
gofmt 本身只是个命令，VS Code 调用的是 gopls，gopls 默认调用 goimports，而 goimports 又依赖 go 命令的 module 解析能力——任一环节断链，格式化就静默失败。 
