普通Enum实例属性仍可被修改，因其成员是普通Python对象，仅类级别禁止增删成员，而自定义字段默认可写；需通过__setattr__拦截或StrEnum+外部映射实现真正冻结。
Python 的 enum 模块默认不保证运行时不可变性，必须显式继承 Enum 的安全子类（如 IntEnum、Flag）或手动冻结——但最稳妥的方式是用 Enum 配合 __slots__ + 自定义 __setattr__，或者直接选用 StrEnum（Python 3.11+）并避免动态赋值。
为什么普通 Enum 实例属性仍可被修改？
很多人误以为 Enum 类本身不可变就等于其成员“完全安全”。实际上：Enum 类禁止新增成员、禁止重写已有成员名，但**已存在的枚举成员实例仍是普通 Python 对象**，其自定义属性（如果有的话）仍可被修改。比如：
from enum import Enum <p>class Color(Enum): RED = 1 GREEN = 2</p><h1>这行不会报错！</h1><p>Color.RED.<em>name</em> = "WRONG"
虽然 _name_、_value_ 等内置描述符受保护，但如果你在枚举类中加了自定义字段（如 description），它默认就是可写的。
立即学习“Python免费学习笔记（深入）”；
如何真正禁用枚举成员的属性写入？
核心思路：让枚举成员实例变成“冻结对象”。Python 没有内置的“只读实例”，但可通过以下方式逼近：
- 使用
__slots__ = ()阻止动态添加属性（对已有属性无效） - 重写
__setattr__抛出AttributeError（需小心别拦住父类初始化） - 推荐组合方案：继承
Enum，在元类或类体中封禁写入
实操建议（兼容 3.8+）：
from enum import Enum
<p>class LockedEnum(Enum):
def <strong>setattr</strong>(self, name, value):
raise AttributeError(f"Cannot modify enum member {self.name}")</p><p>class Status(LockedEnum):
PENDING = 1
DONE = 2</p><h1>可安全添加描述字段，但不能改</h1><pre class="brush:php;toolbar:false;"><pre class="brush:php;toolbar:false;">def __init__(self, value):
self.description = {1: "waiting", 2: "completed"}[value]</code></pre>这样 Status.PENDING.description = "oops" 会立刻报 <code>AttributeError。
Python 3.11+ 推荐用 StrEnum，但仍有陷阱
StrEnum 是 str 和 Enum 的混合，常用于 API 字符串校验，但它**不自动冻结成员**。常见错误是以为继承 StrEnum 就万事大吉：
from enum import StrEnum <p>class Role(StrEnum): ADMIN = "admin" USER = "user"</p><h1>这行依然合法（且危险）：</h1><p>Role.ADMIN += "_test"
原因：字符串枚举成员本质是 str 实例，而 str 不可变，但 += 是重新绑定变量名，不是修改原对象。真正风险在于你给成员额外挂属性：
- 别在
StrEnum成员上设属性（如Role.ADMIN.level = 99） - 若需扩展信息，改用
__members__映射或外部字典，而非挂载到实例 - 需要强约束时，配合
typing.Final注解（仅静态检查，不阻止运行时）
枚举类本身的“不可变性”边界在哪？
要清楚 Enum 的保护范围：
- ✅ 禁止向类中添加新成员：
Status.NEW = 3→TypeError - ✅ 禁止重复定义同名成员：
PENDING = 99→ValueError - ❌ 允许修改类属性（如
Status.__doc__ = "new doc"） - ❌ 允许修改成员的自定义实例属性（除非你像前面那样主动拦截）
- ❌ 不阻止通过
globals()或反射替换整个枚举类名绑定（这属于 Python 通用规则，无法靠 enum 解决）
真正关键的防线不在枚举定义本身，而在使用侧：永远把枚举当“值”而非“可配置对象”，所有业务逻辑应基于 .name 和 .value 做判断，避免依赖运行时注入的字段。
