Python枚举类定义常量与比较方法

Python枚举类（Enum）是定义常量集合最安全、可读性最强的方式，远胜手写类或字典；必须显式赋值（推荐`auto()`避免编号错误），IntEnum和StrEnum虽支持与整数/字符串直接比较，但易引发类型混淆和语义模糊；不同枚举类间绝不相等，安全比较应使用`is`而非`==`，跨类型混用需格外谨慎；枚举默认不支持JSON序列化，需通过自定义`default`函数或Pydantic实现，同时务必分清`.value`与`.name`——这个看似微小的点号之差，正是调试中高频出错的根源。

用 Enum 定义常量集合，别手写类或字典

直接继承 Enum 是最干净的方式，比用 class Status: PENDING = 1; DONE = 2 或 {'PENDING': 1, 'DONE': 2} 更安全、可读性更强。它天然防止重复值、支持迭代、能被序列化，还自带类型提示支持。

常见错误是把枚举成员写成字符串字面量但没赋值，比如 class Color(Enum): RED, GREEN, BLUE —— 这会报 TypeError: Enum class cannot be extended，因为 Python 不允许空成员。

• 必须显式赋值：RED = 1、GREEN = "green"、BLUE = auto()
• 推荐用 auto() 避免手动编号出错，需导入 from enum import auto
• 如果值需要参与 JSON 序列化，优先选简单类型（int、str），避免嵌套对象

IntEnum 和 StrEnum 的区别在哪

IntEnum 让枚举成员可以和整数直接比较（比如 status == 2），但容易模糊类型边界；StrEnum（Python 3.11+）同理支持字符串比较，但更常用于配置键名或 API 字段名。

典型误用：在函数参数里接受 int 却传入 IntEnum 成员——虽然能过，但语义混乱，调用方可能误以为传普通数字就行。

• IntEnum 成员是 int 的子类，isinstance(Color.RED, int) 返回 True
• StrEnum 成员是 str 的子类，适合做日志级别、状态码字符串等
• Python < 3.11 没 StrEnum，可用 Enum + 自定义 __str__ 替代，但不推荐重载魔术方法来模拟

枚举成员比较时为什么有时相等、有时不等

核心看是否用了同一枚举类。不同枚举类即使值相同也不相等：Status.PENDING == Priority.LOW 永远是 False，哪怕两者值都是 1。

另一个坑是用 == 比较枚举成员和原始值：默认 Enum 不支持，而 IntEnum / StrEnum 支持，但这是“隐式转换”，容易掩盖类型错误。

• 安全做法：统一用 is 判断同一枚举实例（status is Status.PENDING）
• 避免跨类比较，也别依赖 == 和原始值混用，除非明确用了 IntEnum 并接受其行为
• 如果要支持值比较，显式定义 __eq__，但多数场景没必要

怎么让枚举支持 JSON 序列化和反序列化

标准 json.dumps() 会报 TypeError: Object of type Status is not JSON serializable，因为枚举不是内置 JSON 类型。

最简方案是加一个自定义 default 函数，但要注意反序列化时得靠业务逻辑映射回来，JSON 本身不保存类型信息。

• 序列化：json.dumps(obj, default=lambda x: x.value if isinstance(x, Enum) else None)
• 反序列化：不能自动还原为枚举，需在解析后手动转，比如 Status(data['status'])
• 如果用 Pydantic，BaseModel 默认支持枚举字段，序列化/反序列化都自动处理，但得确保字段类型标注正确（如 status: Status）

枚举的 value 和 name 容易混淆，尤其在调试时打印出来看着像字符串或数字就以为可以直接用——其实访问 .value 和 .name 是两回事，漏掉点号是高频低级错误。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《Python枚举类定义常量与比较方法》文章吧，也可关注golang学习网公众号了解相关技术文章。