Go中无enum关键字，iota是唯一可靠替代方案，本质是const块内行号计数器，需显式定义底层类型、实现Stringer接口及自定义MarshalJSON方法。
Go 里没有 enum 关键字，但 iota 是唯一靠谱的替代方案
Go 语言确实不支持传统意义上的 enum（比如 Java 或 C# 那种带作用域、可继承、自带字符串映射的枚举），iota 不是语法糖，也不是类型系统的一部分——它只是常量声明块里的一个“行号计数器”。你用它写出来的枚举，本质是一组命名的整型常量，类型和值都得自己管。
常见错误现象：type Status int; const ( Active Status = iota; Inactive ) 看似合理，但一旦漏写类型别名（比如直接写 const ( Active = iota )），Active 就是未指定类型的 untyped int，后续传参或比较时容易触发隐式转换失败。
- 必须显式定义底层类型（如
type Level int），再让常量基于该类型声明 -
iota每次出现在新的const块开头才重置为 0；同一块内每行自增 1，跳过空行但不跳过注释行 - 想跳过某个值（比如留出 0 表示无效状态），用
_ = iota或Unused = iota占位
给 iota 枚举加 String() 方法，否则日志和调试全是数字
Go 的 fmt.Printf("%v", status) 默认只输出整数值，根本看不出是 Active 还是 Pending。这不是 bug，是设计使然：Go 不自动为整型常量生成字符串映射，必须手动实现 Stringer 接口。
使用场景：API 返回状态码、日志记录、HTTP 响应体序列化（尤其用 json.Marshal 时，默认仍输出数字）。
立即学习“go语言免费学习笔记（深入）”；
性能影响：每次调用 String() 都是查表或 switch，只要不超过几十个值，开销可忽略；但若枚举成员上百，建议用 map 缓存，不过多数业务枚举远没那么多。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 方法签名必须是
func (s YourEnumType) String() string，接收者类型要和常量类型严格一致 - switch 分支必须覆盖所有有效值，否则未匹配时返回空字符串——这会让调试极其痛苦
- 如果用了
iota跳值（如_ = iota; A; B），switch 里不能漏掉中间被跳过的数字，否则 panic 或静默失败
func (s Status) String() string {
switch s {
case Active:
return "active"
case Inactive:
return "inactive"
default:
return "status(" + strconv.Itoa(int(s)) + ")"
}
}JSON 序列化时输出字符串而非数字，得靠自定义 MarshalJSON
即使实现了 String()，json.Marshal(StatusActive) 依然输出 0，因为 JSON 包不调用 String()。这是最容易踩的坑：前端看到 { "status": 0 }，完全不知道对应哪个语义。
参数差异：MarshalJSON 返回 []byte 和 error，不能只返回字符串；返回的 JSON 必须是合法格式（比如字符串要加双引号）。
- 别在
MarshalJSON里直接调s.String()后套json.Marshal，会无限递归（因为json.Marshal又调你这个方法） - 正确做法是手动拼接字节：比如
return []byte("\"" + s.String() + "\"") - 如果需要同时支持数字和字符串两种输出（如配置开关），得额外加字段或封装结构体，
iota本身不提供这种灵活性
跨包引用枚举常量时，注意 iota 块的可见性与初始化顺序
当把枚举定义在 const 块里并导出（首字母大写），其他包能直接用 mypkg.Active。但若该 const 块上方有变量初始化依赖了 iota 值（比如 var DefaultStatus = Active），而那个变量又在 init() 函数里被读取——就可能触发初始化顺序问题。
兼容性影响：Go 1.21+ 对常量块初始化更严格，某些看似“安全”的跨包常量引用，在测试环境运行正常，但构建为 vendor 模式或启用 -trimpath 时可能暴露隐式依赖。
- 永远不要在
const块外、包级变量声明中直接用iota常量做计算（如var MaxRetries = Active * 2），Go 不保证执行顺序 - 如果枚举值需参与计算（如位运算标志），优先用
1 模式，并确保所有位移值不重叠 - 多个相关枚举（如 HTTP 状态码分组）不要拆到不同
const块，iota会重置，导致值重复
真正麻烦的不是怎么写，而是别人读你代码时，得同时盯住类型定义、常量块、String() 实现、JSON 方法四块地方，才能确认一个值到底代表什么——少看任何一块，都可能误解语义。
