__post_init__ 不自动触发是因为手动定义 __init__ 或设 @dataclass(init=False) 会禁用它；需确保未重写 __init__、正确使用 field(init=False) 和 object.__setattr__（frozen时），并用哨兵对象区分默认值与显式传参。
为什么 __post_init__ 不是自动触发的？
因为 __post_init__ 只在 dataclass 实例化后、且类定义中显式设置了 init=True（默认）时才调用；如果你手动重写了 __init__，它就彻底不生效了——dataclass 不会帮你合并或委托调用。
常见错误现象：__post_init__ 完全没执行，打印语句没输出，字段也没被修正。
- 确认没定义自己的
__init__方法（哪怕只有一行pass） - 检查
@dataclass装饰器参数：确保没写@dataclass(init=False) - 若需自定义初始化逻辑，应保留
__post_init__，并在其中处理，而不是另写__init__
如何在 __post_init__ 中安全地修改字段值？
直接赋值给 self.xxx 是可行的，但必须注意：字段是否为 init=False，否则会触发 TypeError: cannot assign to field 'xxx'（尤其在使用 frozen=True 时）。
典型场景：根据输入字段推导派生字段，比如把 start 和 end 时间字符串转成 datetime 对象，并缓存 duration。
@dataclass
class Event:
start: str
end: str
duration: float = field(init=False) # 不参与 __init__ 参数
<pre class="brush:php;toolbar:false;">def __post_init__(self):
from datetime import datetime
s = datetime.fromisoformat(self.start)
e = datetime.fromisoformat(self.end)
self.duration = (e - s).total_seconds() / 3600
-
field(init=False)字段不能出现在__init__签名里，但可在__post_init__中赋值 - 如果用了
frozen=True，即使init=False，也不能直接self.xxx = ...；得用object.__setattr__(self, 'xxx', value) - 避免在
__post_init__中调用可能抛异常的外部 API——这会让实例化变成“危险操作”，建议提前校验或用工厂函数封装
怎样让 __post_init__ 支持可选字段和默认值逻辑？
当字段带默认值（如 default=None 或 default_factory=list），__post_init__ 仍会被调用，此时要区分是用户传了 None，还是根本没传（即用了默认值）——但 dataclass 不提供“未传入”的元信息，只能靠约定或辅助标记。
推荐做法：用 field(default=MISSING) 配合哨兵对象判断。
from dataclasses import dataclass, field
from typing import Any
<p>MISSING = object()</p><p>@dataclass
class Config:
host: str = "localhost"
port: int = field(default=MISSING)
timeout: int = 30</p><pre class="brush:php;toolbar:false;">def __post_init__(self):
if self.port is MISSING:
self.port = 8080 if self.host == "localhost" else 80
- 不要用
None当哨兵——用户可能合法传入None -
default_factory适合可变默认值（如list），但它总会在__post_init__前执行，无法用于“是否传入”的判断 - 如果逻辑复杂，考虑把初始化拆到类方法（如
from_dict）中，让__post_init__只做轻量级补全
与 __init__ 混用时的兼容陷阱
有人想“先跑父类 __init__，再自己加工”，结果发现 dataclass 生成的 __init__ 不是普通方法，无法用 super().__init__() 显式调用。强行加会导致 TypeError: __init__() takes exactly 1 positional argument。
正确路径只有一条：放弃手写 __init__，全部逻辑塞进 __post_init__。
- 若继承自另一个
@dataclass类，子类的__post_init__需显式调用super().__post_init__()（否则父类逻辑不执行） - 若继承自非
dataclass类（如Exception或dict子类），确保父类不依赖__init__的参数顺序或行为，因为dataclass生成的__init__会覆盖它 - 调试时加
print(f"post_init: {vars(self)}")很有用——但别留在线上，vars()在frozen=True下会失败
最易忽略的一点：__post_init__ 运行时，所有字段都已完成类型注解检查（如果开了 type_check）和默认值填充，但它本身不参与任何类型/约束校验——校验逻辑得你自己写，比如 if not isinstance(self.name, str): raise ValueError(...)。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
