iota 是 go 中 const 块内从 0 开始、每次被引用时加 1 的隐式整数计数器,非枚举关键字;其计数不受空行或注释影响,但若某行未使用 iota 则后续行重置为 0。

Go 中的 iota 不是枚举关键字,而是 const 块里的行号计数器
iota 不是类型、不是函数、也不是语法糖——它只是 Go 编译器在 const 块里悄悄维护的一个整数,从 0 开始,**每次被表达式引用时加 1**,不是“每行加 1”。很多人写错,是因为误以为空行或注释会打断计数,其实不会;但一旦某行没用 iota(比如写了 FlagRead = 1),后续行的 iota 就从 0 重新开始。
- 错误示范:
const ( A = iota // 0 B // 1 C = 100 // ⚠️ 这里中断了 iota 计数 D // 0 ← 不是 2! ) - 正确做法:位标志、状态码、HTTP 状态这类语义无关的常量,必须分开放在独立的
const块里,别贪省事塞一起 - 想跳过某个值?用
_ = iota占位,比留空更明确,也避免后续常量编号错位
定义“真枚举”必须三步走:自定义类型 + iota 赋值 + String() 方法
只写 const ( Pending = iota ),得到的是 untyped int,传给结构体字段或函数参数时大概率报错:cannot use Pending (type int) as type Status。Go 不自动做类型绑定,你得亲手把常量“套进壳里”。
- 先声明类型:
type Status int - 再让常量属于该类型:
Pending Status = iota(注意等号右边要显式写类型) - 最后实现
String():func (s Status) String() string { ... },否则fmt.Println(Pending)只输出0,调试时完全看不出语义 - 别用
int64当底层类型直接接 iota——iota 默认是int,跨平台可能溢出;需要大整数就显式转:Pending Status = Status(iota)
位掩码(Bit Flags)用 iota 必须左移,否则全是 0,1,2…根本不能用
直接写 Read = iota 得到的是 0,Write 是 1,Exec 是 2——这仨做按位或:Read | Write == 1,和 Exec 值冲突,权限逻辑全崩。位掩码的本质是“每个常量只有一位为 1”,必须靠位移生成。
- 正确写法:
const ( PermRead = 1 - 判断是否含某权限,永远用
perm & PermRead != 0,别用==——后者只匹配“恰好等于”,不是“包含” - 建议统一用无符号类型:
type Perm uint,再让常量属于Perm,避免有符号整数在右移或比较时隐式转换出问题 - const 块里混入字符串、数字字面量(如
Desc = "read")会重置 iota,位掩码常量务必独占一个块
JSON 序列化默认输出数字,要字符串就得自己写 MarshalJSON
用了 String() 方法,fmt 包打印好看,但 json.Marshal 完全不认这个——它只看底层值,输出 {"status": 0}。前端或日志系统看不懂,这是线上最常被忽略的坑。
- 必须显式实现:
func (s Status) MarshalJSON() ([]byte, error) - 返回值必须是合法 JSON 字符串,比如
return []byte(`"` + s.String() + `"`),不能只写return []byte(s.String())(缺引号就非法) - 反向解析(从 JSON 字符串还原枚举)需实现
UnmarshalJSON,且要用strings.EqualFold或 map 查表,别用 switch 字符串硬比 - 如果 API 需要兼容旧版数字格式,可加 tag:
json:",string",但前提是类型实现了encoding.TextMarshaler
最麻烦的不是写法,而是忘记:iota 不跨块、String() 不影响 JSON、位掩码不左移就废、类型不显式声明就报错——这些都不是语法报错,而是运行时行为诡异或接口不兼容,得靠经验提前堵住。
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!











