stringer仅支持底层为整数的自定义类型，通过解析//go:generate注释和const iota定义生成String()方法，不支持字符串类型枚举，且未定义值默认返回空字符串。
Go 语言本身没有内置枚举类型，stringer 是官方 golang.org/x/tools/cmd/stringer 工具，专为给自定义整数类型（即“枚举”）自动生成 String() 方法而设计——它不处理字符串类型枚举，也不生成其他方法（如 Parse()），仅解决「打印友好」这一个具体问题。
为什么 stringer 只对整数类型有效
stringer 的原理是解析源码中带 //go:generate stringer -type=XXX 注释的类型定义，然后检查该类型是否底层为 int、uint 等整数类型，并且其值通过 const 块定义（如 iota）。它不识别字符串字面量定义的“枚举”，也不会为 type Status string 类型生成 String() 方法。
- ✅ 支持：
type State int+const ( Active State = iota; Inactive ) - ❌ 不支持：
type Level string+const ( Debug Level = "debug"; Info = "info" ) - ⚠️ 注意：如果 const 值不是连续整数（比如跳过、显式赋值非顺序值），
stringer仍能生成，但生成的switch分支会包含所有显式声明的值，未声明的整数值调用String()会返回空字符串或 panic（取决于是否加-linecomment）
如何正确使用 stringer 生成枚举字符串方法
核心是三步：定义类型 → 定义 const 值 → 插入 go:generate 注释 → 运行生成。必须确保类型和 const 在同一个包、同一文件（或通过 -output 指定位置）。
- 在 const 块上方添加注释：
//go:generate stringer -type=State（State是你的类型名） - 运行命令：
go generate（不是go run或go build）；若未安装工具，先执行：go install golang.org/x/tools/cmd/stringer@latest - 生成的文件默认为
state_string.go，内容含func (s State) String() string，内部用switch s匹配每个 const 值 - 可选参数：
-linecomment会让String()返回 const 行末的注释（如Active State = iota // active→"active"），适合不想重复写字符串字面量的场景
stringer 生成的代码常见陷阱
生成的 String() 方法默认只覆盖你明确定义的 const 值，其余整数值不会 fallback 到数字字符串，而是返回空字符串（例如 fmt.Printf("%s", State(999)) 输出空串），容易掩盖非法值。
立即学习“go语言免费学习笔记（深入）”；
- 调试时发现日志里字段为空？先检查传入值是否超出 const 范围
- 想让未知值输出类似
"State(123)"？需手动修改生成的文件（不推荐）或改用自定义实现（如用 map + sync.Once 初始化） - 生成文件被 git 忽略？建议加入版本控制——它是稳定输出，且
go generate不保证每次生成完全一致（如注释变动会影响内容） - 多个 type 共用一个文件？每个
//go:generate注释只能指定一个-type，多类型需多行注释
真正麻烦的从来不是生成 String()，而是当业务需要反向解析（ParseStatus("inactive")）、校验范围、或跨服务传递时，stringer 什么也帮不上——这时候就得自己补 map、加方法，或者换用更重的方案（如 protobuf enum + protoc-gen-go-stringer）。
