用Enum定义常量最安全可读,需显式赋值(推荐auto()),IntEnum支持整数比较但易混淆类型,StrEnum适合字符串场景;枚举不支持直接JSON序列化,需自定义default或用Pydantic。

用 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 成员——虽然能过,但语义混乱,调用方可能误以为传普通数字就行。
立即学习“Python免费学习笔记(深入)”;
-
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 是两回事,漏掉点号是高频低级错误。


















