gofmt是Go官方强制统一代码风格的不可配置工具，仅按硬编码规则重排代码：tab缩进、操作符空格、括号位置等均不可调；常用命令为gofmt -w格式化并覆写文件。
gofmt 不是用来选风格的工具，它只做一件事：把你的 Go 代码按官方唯一标准重排。你改不了缩进是 tab 还是空格、调不了行宽、也不能让括号换行方式变个样——规则全硬编码在 Go 源码里，不接受任何配置文件或开关。
gofmt -w 是日常唯一需要记住的命令
不加 -w，gofmt 只打印格式化后的内容到终端，不会改文件。很多人跑完 gofmt main.go 看到输出就以为搞定了，结果 git status 一片空白——因为根本没写回。
-
gofmt -w main.go：格式化单个文件并覆盖原文件 -
gofmt -w ./：递归格式化当前模块下所有.go文件（注意是./，不是*或当前目录名） -
gofmt -d ./：预览差异（类似git diff），不写入，适合 CI 校验或提交前检查 -
gofmt -s main.go：启用简化模式（例如把a := make([]int, 0)缩成a := []int{}），但不改变格式逻辑
如果报错 no Go files in，大概率是你不在模块根目录（缺 go.mod），或者路径写成了 .\（Windows 下无效）或 **/*.go（gofmt 不支持 glob）。
VS Code 保存自动格式化失效的真实原因
编辑器里点保存没反应，不是插件坏了，而是底层调用链断了。常见卡点：
- VS Code 找不到
go命令：终端能跑go version，但 VS Code 终端或插件却提示command not found——说明它没读取你 shell 的$PATH，需重启 VS Code 或手动配置"go.goroot" - 格式化工具被悄悄覆盖：
"go.formatTool"被设成"gofmt"以外的值（比如"goimports"），但你根本没装它，导致静默失败 - 实际调用的是
gopls，而你启用了"formatting.gofumpt": true：这时 VS Code 调用的其实是gofumpt，和 CLI 里go fmt ./行为不一致，diff会飘
验证方法很简单：关掉所有编辑器，终端里直接跑 gofmt -w main.go，看是否生效。如果可以，问题一定出在编辑器配置或 PATH 隔离上。
立即学习“go语言免费学习笔记（深入）”；
go fmt 和 goimports 到底该用谁
go fmt 是 gofmt -w 的封装，只管结构重排；goimports 是它的超集，多做了 import 管理——自动增删包、按标准库 / 第三方 / 本地三组排序、字母序排列。两者不能混用。
- 团队协作中，
goimports -w ./更实用：避免 “忘记 import” 或 “import 顺序乱” 导致的编译失败 - 安装方式：
go install golang.org/x/tools/cmd/goimports@latest（注意必须带@latest，否则可能装旧版） - VS Code 中设
"go.formatTool": "goimports"后，保存时既格式化又整理 import，但要注意：没有go.mod的老项目会静默跳过
gofmt -r 的安全边界在哪
gofmt -r 支持简单 AST 级替换（如 gofmt -r "a + b -> b + a" *.go），但它不是通用代码重构工具，且极易误伤：
- 匹配基于语法结构，不是字符串；
a + b只匹配顶层二元加法表达式，不匹配func() int { return a + b }内部的a + b - 没有作用域感知，无法区分变量名、字段名、函数名；
-r "io.Read -> io.ReadFull"可能错误替换注释或字符串字面量 - 它不校验类型或上下文，替换后代码可能编译失败，也不提供回滚机制
真正要改结构，该用 gopls 的重命名或提取函数功能，而不是靠 -r 硬碰。
gofmt 对模块边界的敏感性——它只认 go.mod，不认目录名或 GOROOT。一旦你在非模块路径下执行 gofmt -w ./，它可能什么也不做，还假装成功。这种“静默跳过”比报错更危险。 
