Go 语言推荐使用 goimports 替代 gofmt 进行代码格式化，1. goimports 兼容 gofmt 并增强 import 管理；2. 支持自动增删、排序导入包；3. 可通过 -w 参数写入文件，-d 或 -l 预览差异；4. 编辑器集成实现保存时自动格式化；5. CI/CD 中校验格式一致性，确保代码风格统一。
Go 语言自带了官方格式化工具 gofmt，它不仅是代码风格统一的保障，更是 Go 社区约定俗成的“标准”。在项目中正确配置格式化工具，能避免团队协作中的风格争议，提升代码可读性和 CI/CD 流程稳定性。
使用 gofmt 做基础格式化
gofmt 是 Go 安装时自带的命令行工具，无需额外安装。它只关注语法结构的标准化（如括号位置、缩进、空格），不涉及命名、注释等风格建议。
- 格式化单个文件：
gofmt -w main.go - 格式化整个目录（含子目录）：
gofmt -w ./... - 预览格式化差异（不写入）：
gofmt -d ./...
注意：-w 表示“write back”，即直接覆盖原文件；生产环境建议先用 -d 查看变更再决定是否应用。
用 goimports 替代 gofmt 处理 import
gofmt 不管理导入语句（import），比如不会自动增删包、合并分组或按字母排序。推荐用 goimports —— 它是 gofmt 的超集，兼容所有 gofmt 功能，并增强 import 管理。
立即学习“go语言免费学习笔记（深入）”；
- 安装：
go install golang.org/x/tools/cmd/goimports@latest - 使用方式与 gofmt 一致：
goimports -w ./... - 支持自定义分组规则（如标准库 / 第三方 / 本地包），通过
.goimportsrc配置（较少需手动设）
编辑器集成：保存即格式化
主流编辑器都支持调用 goimports 自动格式化。以 VS Code 为例：
- 安装 Go 扩展（由 Go Team 官方维护）
- 在设置中搜索
format tool，将"go.formatTool"设为"goimports" - 勾选
"editor.formatOnSave"，即可在保存时自动格式化
其他编辑器（如 Goland）默认已集成 goimports，可在设置中确认格式化工具选项。
CI 中强制校验格式一致性
防止未格式化代码合入主干，可在 CI 脚本中加入格式检查步骤：
- 运行
goimports -l ./...：列出所有未格式化的文件，非零退出码表示有差异 - 配合
git diff --no-index /dev/null 可做更精细比对 - 建议在 pre-commit 或 PR 检查阶段执行，失败则阻断合并
不需要引入复杂 linter 工具（如 revive、golangci-lint）来做格式检查——格式化是确定性操作，goimports 足够可靠。
基本上就这些。Go 的格式化哲学是“少即是多”：不提供开关、不鼓励个性化，靠一个稳定工具统一所有人。坚持用 goimports，项目越久越省心。
