gofmt

Go 代码格式化工具

补充说明

gofmt 按 Go 官方风格格式化源码，使用制表符缩进并统一空格、换行和对齐。它只改格式，不做语义修复；go fmt ./... 是常用的批量入口。

常用示例

gofmt -w main.go
gofmt -l .
gofmt -d main.go
gofmt -s -w .
gofmt -r 'a[b:len(a)] -> a[b:]' -w main.go
gofmt < main.go > formatted.go
go fmt ./...

易错点与排错

• -w 会直接改写文件；先 -d 看差异或确保已提交。
• -l 只列出需要格式化的文件，适合 CI 检查。
• -s 会做简化改写，可能改变代码形态；团队要统一是否启用。
• gofmt 不会整理 import 分组和未使用导入；那类工作交给 goimports。
• 生成代码通常也应格式化；把生成步骤放进 go generate 或 CI。
• 格式化差异会制造大量无关 diff；提交前单独跑一次格式提交。
• 不同 Go 版本的格式化结果可能有细微差异；CI 固定版本。

相关命令

• go — Go 工具链
• goimports — 格式化并整理导入