dataclass 是 Python 3.7 引入的语法糖,用于简化数据类定义,支持 field() 精细控制字段、装饰器参数配置全局行为、继承时注意字段顺序与 frozen 冲突,以及通过 post_init 补充初始化逻辑。

dataclass 是 Python 3.7 引入的语法糖,用于简化类的定义,尤其适合只用来存储数据的类。但它远不止“自动生成 __init__”这么简单——通过灵活配置参数,你能控制字段行为、冻结实例、支持继承、定制比较逻辑等。
field():精细控制单个字段
默认情况下,所有带注解的变量都会成为 dataclass 字段,但若需特殊行为(如默认值延迟计算、不参与比较、不被序列化),就得用 field() 显式声明。
-
default和default_factory:前者用于不可变默认值(如int,str),后者用于可变对象(如list,dict),避免多个实例共享同一对象 -
init=False:该字段不参与__init__参数,常用于运行时计算或内部状态 -
repr=False或compare=False:隐藏字段在repr()输出中,或排除在==比较之外 -
kw_only=True:强制该字段只能以关键字参数传入(Python 3.10+)
dataclass() 装饰器参数:全局行为开关
装饰器本身接受多个布尔参数,决定整个类的默认行为:
-
init=True:生成__init__;设为False后需手动实现,适合完全自定义初始化逻辑 -
repr=True:生成__repr__;关闭后print(obj)不再显示字段值,仅显示类名 -
eq=True:生成__eq__(及__hash__若frozen=True);设为False后所有实例默认不相等(除非重写) -
order=False:不生成__lt__等排序方法;启用后按字段顺序逐个比较,要求所有字段都支持比较操作 -
frozen=False:设为True后实例不可变(类似namedtuple),赋值会触发FrozenInstanceError -
unsafe_hash=None:显式控制是否生成__hash__;当frozen=True且无自定义__hash__时自动设为True
继承与字段覆盖:小心顺序和 frozen 冲突
dataclass 支持继承,但子类字段必须排在父类字段之后(否则引发 TypeError)。若父类设了 frozen=True,子类即使设 frozen=False 也无法修改字段值。
立即学习“Python免费学习笔记(深入)”;
- 子类可添加新字段,也可用
field(default=...)覆盖父类同名字段的默认值 - 若父类字段设了
init=False,子类无法通过__init__接收该字段,但可通过其他方式初始化 - 使用
field(default_factory=list)在子类中创建独立副本,避免父类字段被意外共享
自定义方法与 post_init:补充初始化逻辑
dataclass 自动生成 __init__,但有时需要校验、转换或关联字段。这时可定义 __post_init__ 方法,在自动生成的初始化完成后立即执行。
-
__post_init__不接收参数,但可访问所有已初始化字段 - 适合做数据验证(如检查年龄非负)、派生字段计算(如
full_name = first + last)、资源预加载等 - 若类设了
frozen=True,在__post_init__中给字段赋值需用object.__setattr__(self, 'attr', value) - 可结合
field(init=False)使用,把中间计算结果存为只读属性










