Go语言通过gofmt工具强制统一代码风格，规定使用tab缩进、无分号、大括号不换行，并要求import分组、驼峰命名、清晰标识符及规范注释，实现“约定优于配置”的简洁开发体验。
Go语言以简洁和统一著称，官方强烈推荐使用统一的代码风格，避免开发者在格式上浪费时间。Golang没有像其他语言那样提供多种格式化选择，而是直接内置了一套标准——gofmt，并鼓励所有项目遵循这一规范。
1. 使用 gofmt 自动格式化代码
Go 提供了 gofmt 工具，能够自动将代码格式化为标准风格。这是 Go 社区公认的代码格式权威工具，几乎所有项目都要求提交前运行 gofmt。
基本用法：
- gofmt -w file.go：格式化单个文件，并写回原文件
- gofmt -w .：格式化当前目录及子目录下所有 .go 文件
- gofmt -l .：列出所有未格式化的文件（常用于 CI 检查）
大多数编辑器（如 VS Code、GoLand）都支持保存时自动运行 gofmt，建议开启此功能。
立即学习“go语言免费学习笔记（深入）”；
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
2. 标准格式核心规则
gofmt 决定了以下关键格式细节，开发者无需自行决定：
- 缩进使用制表符（tab），而不是空格。默认显示为 4 个字符宽度
- 行尾无分号，Go 编译器会自动插入
-
大括号 { 必须紧跟在语句后，不能另起一行。例如：
if condition {
doSomething()
} - import 分组有序：标准库、第三方库、项目内包通常分三组，每组用空行隔开
- 函数参数、变量声明等对齐不强制，gofmt 不处理此类美化
3. 命名规范：清晰胜于简短
Go 风格强调命名清晰可读，而非过度缩写：
- 使用驼峰命名法（MixedCaps），不使用下划线。例如：GetUserName 而非 get_user_name
- 公共标识符首字母大写，私有则小写。这是 Go 控制可见性的机制
- 尽量避免缩写，除非是广泛接受的（如 ctx 表示 context，id 表示 identifier）
- 接口命名通常以 -er 结尾，如 Reader、Writer、Closer
4. 注释与文档生成
Go 鼓励为导出的函数、类型、变量添加注释，以便生成文档：
- 注释与目标在同一行或上方，且紧贴定义
- 包注释放在 package 前，说明包用途
-
函数注释以函数名开头，例如：
// GetUserName 返回用户的全名
func GetUserName() string { ... } - 使用 godoc 或访问 pkg.go.dev 可查看格式化后的文档
基本上就这些。Go 的设计哲学是“约定优于配置”，代码风格统一是其中重要一环。只要坚持使用 gofmt 并遵守命名习惯，就能写出符合社区标准的 Go 代码。不复杂，但容易忽略。
