“程序员最讨厌两件事：重复造轮子，和别人让我重复造轮子。”
—— 佚名（但大概率是个被 enum 字符串折磨过的 Go 程序员）
1. 问题来了：你是不是也写过这种代码？
type Day int
const (
Monday Day = iota
Tuesday
Wednesday
Thursday
Friday
Saturday
Sunday
)
func (d Day) String() string {
switch d {
case Monday:
return "Monday"
case Tuesday:
return "Tuesday"
// ... 剩下的你懂的，复制粘贴到手抽筋
default:
return "Unknown"
}
}
是不是感觉——这不就是把变量名原样抄一遍吗？
没错！这就是典型的“人肉编译器”行为。而 Go 提供了一个超酷的工具，能让你从此告别这种无聊劳动：go:generate。
2. 什么是 go:generate？
简单说，//go:generate 是 Go 源码里的一行魔法注释。当你运行 go generate 命令时，Go 工具链会自动扫描所有 .go 文件，找到这些注释，并执行你指定的命令！
它不是编译时的一部分，也不是 go build 自动触发的（这点很重要！），而是开发阶段的手动/自动化辅助工具。
✅ 用途举例：
- 自动生成
String()方法（比如上面的 Day）- 生成 mock 接口（配合
mockgen）- 从 Protobuf 生成 Go 结构体
- 把静态资源（如 HTML、图片）嵌入二进制（虽然现在更推荐用
embed）
3. 实战：三步搞定 Day 的 String()
第一步：安装 stringer 工具
go install golang.org/x/tools/cmd/stringer@latest
💡 小贴士：
stringer是官方维护的代码生成工具，专门给整型常量生成String()方法。
第二步：在代码里加一行“咒语”
package main
//go:generate stringer -type=Day
type Day int
const (
Monday Day = iota
Tuesday
Wednesday
Thursday
Friday
Saturday
Sunday
)
func main() {
var day Day = Monday
println(day.String()) // 输出：Monday
}
注意那行注释：//go:generate stringer -type=Day
它告诉 Go：“当我运行 go generate 时，请帮我调用 stringer，为 Day 类型生成字符串方法”。
第三步：施法！
go generate
Boom！自动生成一个新文件：day_string.go，里面是：
func (i Day) String() string {
// 自动生成的 switch 逻辑，省了你 20 行代码
}
然后你直接 go run .，就能看到输出：
Monday
🎉 完美！而且以后你加个 Holiday，只要重新 go generate，String() 自动更新！
4. 为什么团队都应该用 go:generate？
| 优势 | 说明 |
|---|---|
| 减少样板代码 | 不用手动维护重复逻辑，避免拼写错误 |
| 提升一致性 | 所有人生成的代码都来自同一套规则 |
| 集成自然 | 不依赖 Makefile 或 shell 脚本，Go 原生支持 |
| 可版本控制 | 生成命令写在源码里，新人 clone 后也能一键复现 |
🤔 但注意：生成的代码通常要提交到 Git！
因为go generate不是go build的一部分，CI/CD 流程不会自动执行它。所以为了保证“任何人拉代码都能直接跑”，建议把*_string.go这类文件一起提交。
5. 更多应用场景（小彩蛋 🎁）
- Mock 生成：
//go:generate mockgen -source=service.go -destination=mocks/service_mock.go - Protobuf 编译：
//go:generate protoc --go_out=. user.proto - 自定义模板生成（比如 API 客户端）：
//go:generate go run gen_api_client.go
只要你能用命令行跑的工具，都能塞进 go:generate！
6. 总结：别再当人肉代码生成器了！
go:generate 就像你的编程小助手，默默帮你干脏活累活。
它不炫酷，但极其实用——尤其在大型项目中，能显著提升开发效率和代码质量。
下次当你发现自己在“复制粘贴改名字”时，不妨停下来问一句：
“这事儿，能不能让
go:generate干？”
如果答案是 yes，那就赶紧试试吧！你的手指会感谢你 😄
📌 小提醒：
go:generate注释必须以//go:generate开头（注意两个斜杠 +go:不能有空格），且必须放在 package 声明之后、函数/类型之前。
