接口返回的是枚举值时,用 status(value) 查找成员,例如 status("paid")。如果接口返回的是成员名,用 status[name]。未知值应进入明确的错误处理。

定义状态枚举类
首先定义一个继承自 enum.Enum 的类来代表业务状态。枚举成员的值可以是字符串,也可以是整数。为了与接口返回的字符串直接对应,这里将值设为字符串。定义完成后,枚举成员具有不可变性,防止运行时被意外修改。
import enum
class Status(enum.Enum):
PAID = 'paid'
PENDING = 'pending'
CANCELLED = 'cancelled'

通过名称获取枚举实例
当接口返回的是状态名称(如 'paid')时,可以使用 Status['NAME'] 语法进行查找。这种方式直接返回对应的枚举成员实例。如果传入的名称不存在于枚举定义中,Python 会抛出 KeyError,这有助于快速发现数据异常,而不是让程序带着错误状态继续运行。
# 正常情况:通过名称查找
status_name = 'paid'
try:
status_obj = Status[status_name.upper()]
print(f"找到状态: {status_obj}, 值为: {status_obj.value}")
except KeyError:
print(f"未知状态名称: {status_name}")
通过值获取枚举实例及异常处理
如果接口返回的是具体的状态值字符串(例如 'paid'),或者需要确保输入严格匹配已知状态,可以使用 Status(value) 构造函数。这会尝试将输入值转换为对应的枚举成员。若值不在枚举定义范围内,将抛出 ValueError。这种显式的错误处理机制比静默替换或默认值更安全,能强制开发者处理非法数据。
# 正常情况:通过值查找
status_value = 'paid'
try:
status_obj = Status(status_value)
print(f"解析成功: {status_obj.name} -> {status_obj.value}")
except ValueError:
print(f"无效的状态值: {status_value}")
# 异常情况:未知值
unknown_value = 'unknown_status'
try:
Status(unknown_value)
except ValueError as e:
print(f"捕获到预期异常: {e}")
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!











