go fmt 是 gofmt 工具的封装别名，仅按 Go 官方规范重排代码结构（缩进、换行等），不改逻辑、不处理 import 或未使用变量，且无视任何配置文件，规则硬编码。
go fmt 是什么，它能做什么
go fmt 不是一个独立命令，而是 gofmt 工具的封装别名。它只做一件事：按 Go 官方风格规范重排代码结构（缩进、空格、换行、括号位置等），不改逻辑、不加注释、不调整命名。它不处理 import 排序或未使用变量——那是 goimports 或 golangci-lint 的事。
直接用 go fmt 命令格式化单个文件或整个模块
最常用方式是终端执行：
go fmt ./...
这会递归格式化当前模块下所有 .go 文件。注意三点：
-
./...表示“当前目录及所有子目录下的包”，不是通配符，不能写成*.go - 它只修改**已存在且可写**的文件；如果文件被 git 忽略或只读，不会报错但也不会处理
- 它不输出任何成功提示——没消息就是好消息；只有出错时才打印错误路径和原因
为什么 go fmt 不读 .editorconfig 或 .gofmt 配置文件
gofmt（也就是 go fmt）**完全无视任何配置文件**。它的规则硬编码在 Go 源码中，比如：
立即学习“go语言免费学习笔记（深入）”；
- tab 宽度固定为 8 个空格（
-tabwidth=8） - 缩进一律用 tab，不用空格
- 函数参数换行时，左括号必须跟在函数名后，右括号独占一行
你无法通过配置让它用 4 空格缩进，也不能禁用某类重排。所谓“配置”，只能靠外部工具补充，例如：
- 用
goimports -w .替代go fmt来自动管理 import 分组 - 在 VS Code 中配置
"gopls": { "formatting.gofumpt": true }启用更严格的gofumpt - CI 中用
gofumpt -l检查而非修改，避免误提交
在编辑器里自动触发 go fmt 的关键设置
VS Code 和 GoLand 默认调用 gopls 提供格式化服务，但行为取决于配置项：
- 确保
"editor.formatOnSave": true开启 - 检查
"go.formatTool"值：设为"gofumpt"可获得比原生gofmt更激进的清理（如删空行、合并连续声明） - 若用
gofumpt，需先go install mvdan.cc/gofumpt@latest，否则保存时会静默失败 - JetBrains 系列要关掉 “Reformat on paste”，否则粘贴代码后可能被二次格式化导致括号错位
真正容易被忽略的是：编辑器格式化和 CLI 的 go fmt 不一定等价。比如 gopls 默认启用 formatting.gofumpt 时，它调用的是 gofumpt，不是 gofmt —— 这会导致本地保存和 CI 执行 go fmt ./... 结果不一致。
