__post_init__ 不自动触发父类方法，需子类显式调用 super().__post_init__()；仅可安全初始化 init=False 字段，冻结类中须用 object.__setattr__ 赋值。
为什么 __post_init__ 不会在数据类继承链中自动触发
当你在父类定义了 __post_init__，子类又用了 @dataclass 装饰时，Python 默认不会调用父类的 __post_init__ —— 因为子类生成的 __init__ 只会调用自己定义的 __post_init__（如果存在），否则就什么也不调。这不是 bug，是 dataclass 的显式设计：它不自动代理父类钩子。
常见错误现象：Parent.__post_init__ 完全静默执行失败，字段校验或默认值补全没发生，但又不报错。
- 必须在子类
__post_init__中显式写super().__post_init__() - 如果父类不是 dataclass，但你手动继承并想复用逻辑，也要确保父类有该方法且可安全调用
- 注意调用顺序：子类
__post_init__在父类之后执行更安全（避免依赖未初始化字段）
__post_init__ 里不能给 field(default=...) 赋值的原因
dataclass 在生成 __init__ 时，已把 default 或 default_factory 的值直接写入实例属性；__post_init__ 运行时这些字段早已存在。如果你在其中重新赋值，看起来“成功”，但会破坏字段的不可变性语义（尤其配合 frozen=True 时直接抛 FrozenInstanceError）。
使用场景：你想根据其他字段动态算出某个字段值，但又不想暴露给用户传参。
立即学习“Python免费学习笔记（深入）”；
- 正确做法：用
field(default_factory=lambda: ...)或在__post_init__中仅初始化field(init=False)声明的字段 - 错误写法：
self.x = self.y * 2（而x是普通 field 且有 default）→ 语义混乱，测试难覆盖 - 性能影响：
default_factory每次实例化都调用；__post_init__中计算只执行一次，但需承担字段状态不一致风险
在 __post_init__ 中做类型校验和异常处理的实际约束
你可以在 __post_init__ 里 raise ValueError，这确实能拦截非法状态，但要注意：异常堆栈里看不到原始参数来源，调试困难；而且一旦抛出，实例已部分构造（__init__ 已返回对象引用），可能引发资源泄漏（比如中间打开了文件但没关）。
常见错误现象：单元测试里 mock 失败，因为异常发生在 init 后期，而 patch 目标错了位置。
- 推荐组合：用
__post_init__做轻量级业务校验（如 “start_time 必须早于 end_time”），别做 IO 或耗时操作 - 避免在其中调用可能抛异常的第三方函数——除非你明确捕获并转成清晰业务异常
- 如果校验逻辑复杂或依赖外部状态，考虑抽成独立方法，并在文档里注明“该方法可能被
__post_init__调用”
冻结数据类（frozen=True）下修改 __post_init__ 字段的唯一合法方式
当 dataclass 设为 frozen=True，所有字段属性都被设为只读；此时在 __post_init__ 中直接赋值会立即触发 dataclasses.FrozenInstanceError。但有些字段你就是需要“初始化时可写、之后不可变”，比如缓存计算结果。
解决方案只有两个字：绕过。
- 用
object.__setattr__(self, 'field_name', value)—— 这是官方认可的“开锁”方式 - 仅对
field(init=False)字段这么做；普通字段即使绕过 setattr，也会在后续访问时因 frozen 机制报错 - 别用
type(self).__dict__或vars(self).__dict__等黑魔法，兼容性差，且在 Python 3.12+ 可能失效
真正容易被忽略的点：多个 field(init=False) 字段之间如果有依赖关系，__post_init__ 的执行顺序不保证——得靠你自己控制赋值顺序，而不是指望声明顺序。
