Python dataclass 有什么用？和普通类有什么区别？

简化版

dataclass 用来简化以数据承载为主的类定义，会根据字段自动生成 __init__、__repr__、__eq__ 等方法。它适合配置对象、DTO、值对象等场景，但不等于所有类都该写成 dataclass。

详细版

普通类：

class User:
    def __init__(self, name, age):
        self.name = name
        self.age = age

    def __repr__(self):
        return f"User(name={self.name!r}, age={self.age!r})"

dataclass：

from dataclasses import dataclass

@dataclass
class User:
    name: str
    age: int

使用：

u1 = User("Tom", 18)
u2 = User("Tom", 18)
print(u1)       # User(name='Tom', age=18)
print(u1 == u2) # True

常用能力：

自动生成初始化方法；
自动生成可读的调试表示；
默认按字段比较对象；
支持默认值和 field(default_factory=...)；
支持 frozen=True 创建近似不可变对象。

注意：dataclass 的类型注解主要用于字段识别和工具提示，运行时默认不会强制检查类型。

完整版教学

一、dataclass 解决什么痛点

很多类只是用来装数据：

class Point:
    def __init__(self, x, y):
        self.x = x
        self.y = y

如果还要写 __repr__、__eq__，代码会越来越模板化。

dataclass 把这些重复劳动自动生成：

from dataclasses import dataclass

@dataclass
class Point:
    x: int
    y: int

这样类定义更聚焦于“有哪些字段”。

二、默认生成哪些方法

默认情况下，dataclass 会生成：

__init__
__repr__
__eq__

示例：

p = Point(1, 2)
print(p)            # Point(x=1, y=2)
print(p == Point(1, 2))  # True

比较时默认按字段值比较，而不是按对象身份比较。

三、默认值和 default_factory

简单默认值：

@dataclass
class User:
    name: str
    age: int = 18

可变默认值要用 default_factory：

from dataclasses import dataclass, field

@dataclass
class Team:
    members: list[str] = field(default_factory=list)

不要写：

members: list[str] = []

dataclass 会阻止一部分可变默认值错误，因为多个实例共享同一个列表通常不是期望行为。

四、frozen=True 和不可变对象

@dataclass(frozen=True)
class Money:
    amount: int
    currency: str

创建后不能直接修改字段：

m = Money(100, "CNY")
m.amount = 200  # FrozenInstanceError

这适合值对象，例如坐标、金额、配置快照。

不过 frozen=True 不是深度不可变。如果字段本身是列表，列表内部仍然可能被修改。真正需要不可变结构时，要选择不可变字段类型。

五、order=True 和排序

可以生成比较方法：

@dataclass(order=True)
class Student:
    score: int
    name: str

对象会按字段顺序比较。先比 score，再比 name。

如果比较规则复杂，建议显式写 key 函数或自定义比较逻辑，不要让字段顺序暗中决定业务排序。

六、dataclass 不适合什么场景

不适合把所有类都写成 dataclass。

如果一个类：

行为复杂；
封装了大量业务规则；
初始化过程不只是字段赋值；
需要严格控制属性访问；
本质是服务对象而不是数据对象；

普通类会更合适。

dataclass 最适合“数据为主，行为较少”的类。

七、常见误区与追问

易错点：dataclass 不是“自动帮你设计模型”，它只是根据类型注解生成样板方法。字段语义、可变默认值、对象是否应该可变，仍然要你自己判断。

误区：写了类型注解，dataclass 就会在运行时强制类型。 标准库 dataclass 不做运行时类型校验，name: str 更多是给 IDE、类型检查器和代码阅读者看的。
误区：列表字段可以直接写 items: list = []。 这会形成共享可变默认值，dataclass 会拒绝常见的可变默认值写法；正确方式是 field(default_factory=list)。
追问：frozen=True 是绝对不可变吗？ 它会阻止常规属性赋值，但如果字段本身引用可变对象，内部对象仍可能被修改；真正不可变还要选择不可变字段类型。
追问：order=True 依赖什么顺序比较？ 它按字段定义顺序生成比较方法，像比较元组一样逐字段比较；如果排序语义不等于字段声明顺序，就不应随手开启。
误区：dataclass 一定比普通类更适合业务对象。 它适合数据承载型对象；如果类有复杂不变量、生命周期、懒加载、权限校验，显式写普通类可能更清楚。
追问：__post_init__ 适合做什么？ 它在自动生成的 __init__ 执行后调用，适合派生字段、字段间一致性校验和轻量规范化，例如根据 first_name、last_name 生成 full_name。

八、加强记忆

dataclass 是帮你少写数据类样板代码的工具，自动生成初始化、展示和相等比较。它适合 DTO、配置、值对象，但不是业务服务类的万能模板。可变默认值用 default_factory，类型注解默认不做运行时强校验，这两点面试很常问。

简化版

详细版