__post_init__是数据类中执行初始化后验证的唯一合理位置，因@dataclass自动生成__init__且覆盖易出错；它在所有字段赋值完成后调用，需手动调用父类方法，不接收参数，不可返回值，异常应抛出而非用assert。
直接说结论： __post_init__ 是数据类（@dataclass）中执行初始化后验证的唯一合理位置，但它不自动触发、不能替代类型检查、且必须手动调用 super().__post_init__()（如果继承自有该方法的父类）。
为什么不能在 __init__ 里做验证？
因为 @dataclass 会自动生成 __init__，你无法安全覆盖它而不破坏字段赋值逻辑；强行重写容易漏掉字段、绕过默认行为，或与 field(default_factory=...) 冲突。而 __post_init__ 是专为此类需求设计的钩子——所有字段已完成赋值，对象已构造完毕，此时校验最稳妥。
__post_init__ 的基本写法和常见错误
定义时无需装饰器，只需在数据类中声明同名方法。注意：它不接收参数（除了 self），也不应返回值。
- 错误写法：
def __post_init__(self, x):→ 会报TypeError: __post_init__() takes 1 positional argument but 2 were given - 正确写法：
def __post_init__(self):→ 然后访问self.field_name进行校验 - 若使用
field(default_factory=list)，此时self.field_name已是实际对象（如空列表），可直接操作 - 抛出异常用
ValueError或自定义异常，不要用assert（生产环境可能被禁用）
继承场景下必须显式调用父类 __post_init__
如果父类也有 __post_init__，子类定义自己的版本时，Python 不会自动调用父类方法——这点和 __init__ 不同。漏掉会导致父类逻辑失效。
立即学习“Python免费学习笔记（深入）”；
示例：
@dataclass
class Base:
name: str
def __post_init__(self):
if not self.name.strip():
raise ValueError("name cannot be blank")
<p>@dataclass
class Derived(Base):
age: int
def __post_init__(self):</p><h1>必须手动加这行，否则 Base 的校验不执行</h1><pre class="brush:php;toolbar:false;"> super().__post_init__()
if self.age < 0:
raise ValueError("age must be non-negative")
和 __setattr__ 或属性验证器相比有什么区别？
__post_init__ 只运行一次，在对象创建完成时；它不拦截后续赋值。如果你需要每次修改字段都校验，得用 __setattr__ 或 property，但那样会失去 dataclass 的简洁性，也影响序列化兼容性（如 asdict()）。多数场景下，只在构造时校验更合理——毕竟数据类本意是不可变或一次性初始化的结构体。
真正容易被忽略的是：当字段使用 field(repr=False) 或 field(init=False) 时，它们在 __post_init__ 中依然可用，但要注意 init=False 字段不会出现在生成的 __init__ 参数里，必须在 __post_init__ 中手动赋值，否则访问会触发 AttributeError。
