本篇基于 Go 1.25.1 版本，带你彻底掌握官方代码格式化工具，告别杂乱代码！
一、为什么必须用 gofmt？
Go 语言官方规定：所有代码必须遵循统一风格
gofmt 是官方自带的代码格式化神器，好处超多👇
✅ 不用争论缩进、空格、换行
✅ 自动美化代码，一键整洁
✅ 团队协作零风格冲突
✅ 开箱即用，无需安装配置
核心原则：Gofmt’s way is the only way.
（gofmt 的风格就是唯一的官方风格）
二、gofmt 核心用法速查表
| 命令 | 功能 | 高频场景 |
|---|---|---|
gofmt -w 文件名.go | 格式化并直接写入文件（最常用） | 格式化单个文件 |
gofmt -w . | 格式化当前目录所有go文件 | 整理当前目录 |
gofmt -w ./... | 递归格式化所有子目录 | 格式化整个项目 |
gofmt -l 文件名.go | 列出需要格式化的文件 | 检查哪些文件不规范 |
go fmt | go封装的gofmt，等价gofmt -l -w | 日常开发首选 |
三、超直观 Demo 对比（前后一致）
1. 杂乱代码（格式化前）
创建 bad.go，复制这段不规范代码：
//bad.go 格式化前
package main
import "fmt"
func main( ){
fmt.Println("hello go");
name:="gofmt"
fmt.Println("使用",name)
}2. 执行格式化命令
# 一键格式化 + 覆盖原文件（最常用！）
gofmt -w bad.go3. 美化后代码（官方标准）
// bad.go 格式化后
package main
import "fmt"
func main() {
fmt.Println("hello go")
name := "gofmt"
fmt.Println("使用", name)
}4. 日常最简命令
# Go 封装版，比gofmt更好用
go fmt bad.go四、gofmt 自动优化哪些内容？
| 优化项 | 格式化前 | 格式化后 |
|---|---|---|
| 缩进空格 | 混乱缩进 | 统一tab缩进 |
| 大括号位置 | 函数{ 换行 | 强制同行{ |
| 空格规范 | name:="a" | name := "a" |
| 多余分号 | 自动删除 | 自动删除行尾分号 |
| 导入分组 | 杂乱import | 整齐排列 |
| 空行规范 | 空行混乱 | 标准空行分隔 |
五、Go 官方代码规范（gofmt 遵循的标准）
- 1. 缩进：使用 tab 缩进，禁止空格
- 2. 大括号：绝不换行！
// 错误 func main() { } // 正确（gofmt强制） func main() { } - 3. 运算符两侧：必须加空格
a := 1 + 2 - 4. 包与导入：必须空行分隔
- 5. 行长度：不强制，但建议不超过80字符
六、项目级格式化（实战必备）
1. 初始化项目
go mod init go-fmt-demo2. 格式化整个项目（递归所有文件夹）
# 方法1：gofmt
gofmt -w ./...
# 方法2：go fmt（更简单，推荐！）
go fmt ./...3. 检查哪些文件没格式化
gofmt -l .七、VS Code / Goland 自动保存格式化
VS Code
- 1. 安装 Go 官方插件
- 2. 打开设置 → 搜索
format on save - 3. 勾选 ✅ 自动格式化
Goland
- 1. 设置 → Tools → File Watchers
- 2. 添加 gofmt / go fmt
- 3. 保存自动格式化
以后写代码，再也不用手动排版！
八、完整项目结构
go-fmt-demo/
├── go.mod
├── bad.go // 杂乱代码
└── good.go // 格式化后📌 总结
- 1. gofmt：Go 官方格式化工具，必须用
- 2. 最常用命令：
go fmt ./...格式化整个项目 - 3. 核心规则：大括号不换行、运算符加空格、统一tab缩进
- 4. 编辑器配置：保存自动格式化，一劳永逸
一行命令搞定代码颜值，专业 Go 开发者的必备习惯 ✨
