Enum优于字符串或数字常量，因其强制声明合法值、支持编译期校验、IDE自动补全、防止拼写错误（如"procssing"）及明确语义（避免2代表何意）。
为什么直接用字符串或数字定义状态不如用Enum
因为字符串容易拼错、无法被 IDE 自动补全，数字常量又缺乏语义——比如 "processing" 写成 "procssing" 或 2 到底代表什么，只有翻注释才知道。而 Enum 强制你把所有合法值提前声明，类型检查器（如 mypy）和编辑器都能立刻识别出非法赋值。
常见错误现象：传入不存在的枚举成员，比如 Status["procssing"] 抛出 KeyError；或者误用 == 比较不同枚举类的值，结果为 False 却没意识到类型不兼容。
- 使用场景：状态机（订单状态、任务状态）、协议字段（HTTP 方法、日志级别）、配置开关（
LogLevel.DEBUG） -
Enum成员不可变，不能动态增删，避免运行时污染 - 若需支持字符串/整数双向转换，优先选
StrEnum（Python 3.11+）或IntEnum，而非手动写__str__
如何定义带值和方法的枚举（不是只列名字）
纯名字枚举（class Color(Enum): RED = 1; GREEN = 2）太单薄。实际中常需要附加元数据或行为，比如每个 HTTP 状态码对应描述文本和是否为成功响应。
正确做法是继承 Enum 后，在 __init__ 中绑定属性，或用 @property 封装逻辑：
立即学习“Python免费学习笔记（深入）”；
from enum import Enum
class HttpStatus(Enum):
OK = (200, "Success")
NOT_FOUND = (404, "Not Found")
SERVER_ERROR = (500, "Internal Error")
def __init__(self, code: int, phrase: str):
self.code = code
self.phrase = phrase
@property
def is_success(self) -> bool:
return 200 <= self.code < 300
- 不要在枚举成员里直接写复杂表达式（如
datetime.now()），会导致模块导入时执行 - 若值是字典或嵌套结构，考虑改用
dataclass+ 实例化对象，Enum不适合存大量可变数据 -
__init__的参数顺序必须和赋值元组一致，否则会静默失败
Enum 和 match 语句配合时的坑
Python 3.10+ 支持 match 对枚举做结构匹配，但容易忽略两点：一是必须用成员名（HttpStatus.OK），不能用值（200）；二是 _ 通配符不会自动捕获成员对象，要显式命名。
错误写法：match status: case 200: ... —— 这匹配的是整数字面量，不是枚举成员，类型检查器会报错。
- 正确写法：
match status: case HttpStatus.OK: ... - 若想解构值：
case HttpStatus.OK as s if s.code > 199: - 不建议在
match中混用不同枚举类，IDE 很难推断类型，易漏case _:
序列化/反序列化枚举时最常踩的兼容性问题
JSON 默认不认 Enum，json.dumps(Status.PENDING) 会抛 TypeError。别急着写全局 default=... 回调，先确认需求边界：
- 前端只关心字符串名？用
status.name（如"PENDING"） - 前端需要稳定数字 ID？用
status.value（如1），但注意IntEnum的value是int，Enum的value可能是元组 - Pydantic v2 默认把枚举转成
.name，如需改成交互式 API 常用的.value，得设model_config = ConfigDict(use_enum_values=True) - 数据库 ORM（如 SQLAlchemy）通常需要显式映射，
Enum字段要配enum参数并指定values_callable防止迁移脚本失效
真正麻烦的是跨语言场景：Python 枚举名大写，Go 枚举习惯小写，Java 喜欢驼峰——别指望靠名字自动对齐，得在序列化层加一层适配逻辑。
