Go 语言通过 iota 实现类型安全的枚举，iota 在 const 块中从 0 自动递增，配合自定义类型可避免魔法数字；支持跳过值（_ = iota）、偏移起始值（iota + 1）和位运算（1

在 Go 语言中没有原生的 enum 关键字，但通过 iota 可以非常简洁、安全地实现常量枚举，既保证类型约束，又避免魔法数字。

用 iota 定义基础枚举类型

iota 是 Go 的常量计数器，仅在 const 块中有效，从 0 开始自动递增。配合自定义类型，能构建出语义清晰的枚举：

例如定义 HTTP 状态码类别：

type StatusCode int

const (
    StatusOK StatusCode = iota     // 0
    StatusCreated                 // 1（iota 自动+1）
    StatusBadRequest              // 2
    StatusNotFound                // 3
    StatusInternalServerError     // 4
)

这样所有状态码都属于 StatusCode 类型，编译期就能防止与其他整数混用。

立即学习“go语言免费学习笔记（深入）”；

跳过值或设置起始值

iota 可配合表达式灵活控制值。常见做法包括：

Golang Uber Dig

使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等

下载

• 用下划线跳过某个位置：_ = iota
• 用 iota + 1 让枚举从 1 开始
• 用位运算生成标志位（如 1 ）

例如定义权限位：

type Permission int

const (
    Read Permission = 1 << iota  // 1 (0001)
    Write                       // 2 (0010)
    Delete                      // 4 (0100)
    Admin                       // 8 (1000)
)

支持按位组合： Read | Write，也便于用 & 判断权限。

为枚举添加字符串描述（Stringer 接口）

实现 String() string 方法后，打印或日志中会自动显示可读名：

func (s StatusCode) String() string {
    switch s {
    case StatusOK:
        return "OK"
    case StatusCreated:
        return "Created"
    case StatusBadRequest:
        return "Bad Request"
    case StatusNotFound:
        return "Not Found"
    case StatusInternalServerError:
        return "Internal Server Error"
    default:
        return "Unknown Status"
    }
}

之后 fmt.Println(StatusCreated) 输出 Created，调试和日志更友好。

避免常见陷阱

使用 iota 枚举时需注意：

• 每个 const 块独立重置 iota，跨块不延续
• 若常量未显式赋值且前一行无等号，会隐式复用上一行的值（不是 iota），容易误判
• 建议始终显式写出类型（如 StatusOK StatusCode = iota），增强可读性和类型安全
• 枚举值不宜导出过多，必要时可用小写首字母 + var 封装默认值

不复杂但容易忽略。