Go语言无原生枚举，推荐用iota+自定义类型实现类型安全枚举，标配String()和JSON序列化方法，支持分组/显式值控制，并用go-enum等工具生成辅助方法提升可维护性。
Go 语言没有原生枚举（enum）关键字，但用 iota 配合自定义类型和常量组，可以写出语义清晰、类型安全、易于维护的枚举。2025 年推荐写法强调可读性、可扩展性、JSON 友好性与 IDE 支持，而非仅追求“一行 iota”。
基础：带类型的 iota 枚举（必做）
避免裸 int 常量，始终绑定自定义类型，获得编译期类型检查和方法扩展能力：
type Status int
const (
StatusUnknown Status = iota
StatusPending
StatusApproved
StatusRejected
)
这样 StatusPending + 1 会编译报错，而 int(StatusPending) + 1 才允许——明确区分“枚举值”和“整数运算”。
增强：添加 String() 和 MarshalJSON（推荐标配）
让枚举可打印、可序列化，提升调试和 API 兼容性：
立即学习“go语言免费学习笔记（深入）”；
- 实现
String()方法，返回有意义的名称（非数字） - 实现
MarshalJSON()和UnmarshalJSON()，支持 JSON 字符串或数字双向解析（按需选一种主流风格）
示例（字符串风格，更易读）：
func (s Status) String() string {
names := map[Status]string{
StatusUnknown: "unknown",
StatusPending: "pending",
StatusApproved: "approved",
StatusRejected: "rejected",
}
if name, ok := names[s]; ok {
return name
}
return "status?" // 或 panic/fmt.Sprintf("status(%d)", s)
}
func (s Status) MarshalJSON() ([]byte, error) {
return json.Marshal(s.String())
}
func (s *Status) UnmarshalJSON(data []byte) error {
var str string
if err := json.Unmarshal(data, &str); err != nil {
return err
}
*s = statusFromString(str)
return nil
}
func statusFromString(s string) Status {
switch s {
case "unknown": return StatusUnknown
case "pending": return StatusPending
case "approved": return StatusApproved
case "rejected": return StatusRejected
default: return StatusUnknown
}
}
进阶：分组 + 显式值控制（应对业务演进）
当枚举需逻辑分组（如 HTTP 状态码）、预留空位、或兼容外部协议时，避免全靠 iota 自增：
- 用空行分隔语义组
- 用
_ = iota跳过不使用的值 - 显式赋值覆盖
iota（如StatusHTTP400 Status = 400）
示例（状态码分组）：
type HTTPCode int
const (
// Success
HTTP200 HTTPCode = iota
HTTP201
HTTP204
_ // 跳过 205–299
// Client Error
HTTP400 HTTPCode = 400
HTTP401
HTTP403
HTTP404
HTTP422
// Server Error
HTTP500 HTTPCode = 500
HTTP502
HTTP503
)
实用技巧：生成辅助方法（减少手写）
对大型枚举（如 20+ 项），手动写 String() 和反查容易出错。2025 年推荐：
- 用 go-enum（稳定、轻量）或 gqlgen 的 enum 插件自动生成
- 在
go.mod中配置//go:generate go-enum -f=status.go，运行go generate即得完整方法集 - 生成内容包含
Values()、IsValid()、FromName()等，大幅提升使用效率
手写不是不行，但中大型项目里，生成代码是更优雅、更可持续的选择。
