iota 是 go 中仅在 const 块内按行自增的常量生成器，非枚举类型；真正模拟枚举需结合自定义类型（如 type status int）及方法（String、marshaljson 等）实现类型安全、可读性与序列化控制。
Go 里没有 enum 关键字，iota 是什么角色
iota 不是枚举类型，它只是常量生成器，只在 const 块里按行自增。它本身不带类型、不带语义，更不自动绑定字符串名。很多人误以为写个 iota 块就等于“定义了枚举”，结果后续没法打印名字、无法校验范围、序列化成 JSON 时还是数字——全是坑。
真正要模拟枚举，必须配合自定义类型 + 方法。比如：
type Status int const ( Pending Status = iota // 0 Running // 1 Done // 2 )这里 Status 是新类型，iota 只负责给它的值赋初值，别把它当枚举本体。
为什么不能直接用 int 而要定义 type Status int
用裸 int 会导致类型擦除：函数参数接受 int，你传个状态码进去编译器完全不拦；日志里打出来只有数字，看不出是状态还是用户 ID；做 switch 时也容易漏掉非预期值（比如传入 999）。
立即学习“go语言免费学习笔记（深入）”；
定义新类型后，能获得这些实际好处：
-
Status和int不兼容，强制类型检查 - 可以为
Status实现String()方法，打印可读名 - 能加
IsValid()方法校验是否落在合法范围内 - JSON 序列化时可通过
MarshalJSON控制输出格式（数字 or 字符串）
常见错误：iota 被意外重置或跳过
iota 在每个 const 块里独立计数，且从 0 开始。以下写法极易出错：
const ( A = iota // 0 B // 1 C // 2 ) const ( X = iota // 0 ← 这里又从 0 开始了！不是接上 C 的 3 )还有更隐蔽的坑：
- 中间插了带等号的常量（如
D = 100），后面iota不会自动跳过，而是继续递增（E变成 101） - 用了
_ = iota占位但忘了后续值没对齐，导致语义错位 - 把不同语义的常量混在一个
const块里，iota数值被复用，后期扩展难维护
建议：一个 const 块只对应一个枚举类型，显式写出每个值（哪怕重复），比依赖 iota 更清晰。
如何让枚举支持打印名字和 JSON 输出字符串
Go 枚举没内置反射名映射，必须手动实现。最简可行方案是加 String() 方法：
func (s Status) String() string { switch s { case Pending: return "pending" case Running: return "running" case Done: return "done" default: return "status(" + strconv.Itoa(int(s)) + ")" } }这样 fmt.Println(Pending) 就输出 pending，而不是 0。JSON 方面，如果想输出字符串而非数字，得实现：
func (s Status) MarshalJSON() ([]byte, error) { return json.Marshal(s.String()) }注意：这会让所有 JSON 场景都输出字符串；如果部分字段要数字、部分要字符串，就得拆成两个类型，或者用包装 Struct —— 这点很容易被忽略，直到 API 兼容性出问题才反应过来。