go fmt 是 gofmt 工具的封装别名，仅按 Go 官方规范重排代码结构（缩进、换行等），不改逻辑、不处理 import 或未使用变量，且无视任何配置文件，规则硬编码。

go fmt 是什么，它能做什么

go fmt 不是一个独立命令，而是 gofmt 工具的封装别名。它只做一件事：按 Go 官方风格规范重排代码结构（缩进、空格、换行、括号位置等），不改逻辑、不加注释、不调整命名。它不处理 import 排序或未使用变量——那是 goimports 或 golangci-lint 的事。

直接用 go fm

t 命令格式化单个文件或整个模块

最常用方式是终端执行：

go fmt ./...

这会递归格式化当前模块下所有 .go 文件。注意三点：

• ./... 表示“当前目录及所有子目录下的包”，不是通配符，不能写成 *.go
• 它只修改**已存在且可写**的文件；如果文件被 git 忽略或只读，不会报错但也不会处理
• 它不输出任何成功提示——没消息就是好消息；只有出错时才打印错误路径和原因

为什么 go fmt 不读 .editorconfig 或 .gofmt 配置文件

gofmt（也就是 go fmt）**完全无视任何配置文件**。它的规则硬编码在 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 ./... 结果不一致。