如何在Python中实现不可变数据类Frozen dataclass-Python教程-PHP中文网

frozen=True仅实现浅层不可变，禁止字段引用重绑定但不阻止可变对象（如list、dict）的原地修改；需用tuple/frozenset等不可变类型或__post_init__中转换。

如何在python中实现不可变数据类frozen dataclass

为什么 `frozen=True` 不能完全阻止修改

启用 frozen=True 后，dataclass 确实会禁止对实例字段的直接赋值（比如 obj.x = 1 会抛出 dataclasses.FrozenInstanceError），但它**不冻结字段值本身的可变性**。如果某个字段是 list 或 dict，你依然可以调用 .append()、.update() 这类原地修改方法。

常见错误现象：FrozenInstanceError 没出现，但对象“看起来”被改了——其实是内部容器被篡改了。

使用场景：需要真正语义不可变（如作为 dict 的 key、用于缓存键、多线程共享）
根本原因：Python 的“不可变”指引用不可重绑定，而非对象内容不可变
解决方向：要么用真正不可变类型（tuple, frozenset），要么在初始化时做深拷贝或转换

如何安全地初始化含可变默认值的 frozen dataclass

直接写 field(default=[]) or field(default={}) 在 frozen=True 下仍会报错——不是因为冻结，而是因为可变默认值本身在 dataclass 中就是禁止的（哪怕没开 frozen）。必须用 default_factory，且工厂返回的必须是不可变对象，或立即转为不可变。

@dataclass(frozen=True)
class Config:
    tags: tuple = field(default_factory=tuple)  # ✅ 安全：tuple 是不可变的
    aliases: frozenset = field(default_factory=frozenset)  # ✅
    # ❌ 不要这样：default_factory=list → 实例字段仍是可变 list

避免 default_factory=list + frozen=True 组合，看似合法，实则埋雷
若业务逻辑确实需要 list 输入，应在 __post_init__ 中转成 tuple：object.__setattr__(self, 'tags', tuple(self.tags))
注意：在 __post_init__ 中修改字段必须用 object.__setattr__，否则触发 FrozenInstanceError

`copy.deepcopy` 对 frozen dataclass 的影响

对 frozen dataclass 实例调用 copy.deepcopy 是安全的，结果仍是 frozen 实例——但前提是所有字段值本身支持深拷贝，且没有自定义 __deepcopy__ 破坏冻结语义。

macOS UI 自动化技能包 —— 用 Python 控制你的 Mac

让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限

下载

容易踩的坑：deepcopy 不会帮你把 list 字段变成 tuple；它只复制结构，不转换类型。所以如果原始实例字段是 [1,2]，深拷贝后还是可变 list。

性能影响：深拷贝开销大，尤其嵌套深或含大容器时；如非必要，优先用不可变字段设计
兼容性注意：某些 C 扩展对象（如 NumPy 数组）可能不完全遵循标准 __deepcopy__ 协议
替代方案：用 dataclasses.replace() 创建新实例（仅适用于字段值本身不可变的情况）

与 `NamedTuple` 和 `typing.NamedTuple` 的关键区别

很多人误以为 frozen=True 的 dataclass 就等价于 NamedTuple，其实不然。最实质的差异在于：NamedTuple 的字段**天生不可变且不可扩展**（无法动态加属性、无法继承添加新字段），而 frozen dataclass 仍保留普通类的运行时行为（比如能定义方法、支持继承、允许 __slots__ 控制）。

典型错误：试图给 frozen dataclass 实例动态赋值 obj._cache = {} —— 会失败；但 NamedTuple 连这个尝试都不允许（AttributeError 更早抛出）。