Go中无enum关键字,仅能通过const块+iota实现编译期整数常量枚举;iota在同const块中从0自动递增,支持跳过、偏移、位运算等变形用法。

Go 里没有 enum 关键字,但 iota 是唯一靠谱的常量枚举方案
Go 不支持类似 Java 或 C# 的 enum 语法,也没有运行时枚举类型。所谓“枚举”,只能靠 const 块 + iota 实现编译期整数常量序列。它不是类型安全的枚举,但足够轻量、高效,且被标准库和主流项目广泛采用(比如 os.FileMode、http.StatusCode)。
关键点:只要在同一个 const 块中,iota 就从 0 开始自动递增;每新增一行带 iota 的常量声明,值就 +1;空行或非 const 行不会重置 iota,但会跳过该行计算。
iota 基础用法与常见变形写法
最简形式就是顺序编号,但实际中几乎总会配合位运算、偏移、表达式使用。不加修饰地裸用 iota 很少能满足业务语义。
- 默认从 0 起始:
const ( StatusPending iota // 0 StatusRunning // 1 StatusDone // 2 ) - 跳过 0,从 1 开始:
const ( _ = iota // 忽略第 0 个 StatusPending StatusRunning StatusDone ) - 按位定义标志位(适合组合状态):
const ( Read = 1 << iota // 1 Write // 2 Execute // 4 Delete // 8 ) - 带前缀字符串或自定义偏移:
const ( ErrUnknown = iota + 1000 ErrTimeout ErrNotFound ErrConflict )
为什么不能把 iota 拆到多个 const 块里?
每个 const 块里的 iota 独立计数,互不影响。误拆会导致重复值、语义断裂,甚至隐藏 bug。
立即学习“go语言免费学习笔记(深入)”;
错误示范:
const (
TypeUser = iota // 0
TypeAdmin // 1
)
const (
CodeOK = iota // 又从 0 开始 → 冲突!
CodeErr // 1,和 TypeUser 值相同但类型不同
)
正确做法是合并或显式赋值:
const (
TypeUser = iota + 100
TypeAdmin
CodeOK = iota + 200
CodeErr
)或者更推荐用类型封装(见下一点)。
加一层 type 包装提升可读性和类型安全
单纯用 int 常量,调用方仍可能传错值(比如把 StatusRunning 当作 HTTPStatus 传)。加自定义类型能利用 Go 编译器做参数校验。
type Status int
const (
StatusPending Status = iota
StatusRunning
StatusDone
)
func HandleStatus(s Status) { / ... / }
// 下面这行会编译报错:cannot use 1 (untyped int) as Status value
// HandleStatus(1)
// 必须显式转换或用常量
HandleStatus(StatusRunning)
注意:如果后续要实现 String() 方法用于日志或调试,必须为该类型单独定义方法,且不能作用于基础类型别名(如 type Status = int)——那只是 alias,不是新类型。
真正麻烦的不是写法,而是团队协作时有人随手加了个新常量却忘了更新配套的 String() 方法或文档,导致日志里只打印数字。这种隐性耦合,得靠测试或代码审查来兜底。










