Python 枚举最佳实践指南

本技能提供 Python 枚举的全面使用指导，从基础定义到高级模式，覆盖 Web 框架集成、数据库 ORM、序列化、模式匹配等实战场景。

何时使用此技能

• 在 Python 项目中定义新的枚举类型
• 重构硬编码字符串/魔法数字为枚举
• 枚举与 Pydantic / FastAPI / Django / SQLAlchemy 集成
• 枚举序列化（JSON、API 响应、数据库存储）
• 使用 match/case 进行模式匹配
• 需要位运算标志（Flag）的场景

1. 枚举定义基础

1.1 始终继承 str 或 int

裸 Enum 的值不能直接序列化，也无法与字符串/整数直接比较。必须混入基础类型：