Skip to content

数据类(Dataclass)

一句话解释

@dataclass 自动为数据密集型类生成样板方法(__init__、__repr__、__eq__)。

用大白话说

@dataclass 装饰器(Python 3.7+)消除了主要持有数据的类的样板代码。你不用手写 __init__、__repr__、__eq__,而是用类型注解声明字段,装饰器会自动生成它们。选项包括 frozen=True(不可变)、order=True(生成 __lt__、__le__ 等)、slots=True(节省内存)。数据类非常适合配置对象、DTO、数据库记录以及数据比行为更重要的任何类。

示例

python
from dataclasses import dataclass, field

@dataclass(frozen=True, order=True)
class Point:
    x: float
    y: float
    tags: list = field(default_factory=list)

p1 = Point(1.0, 2.0)
p2 = Point(1.0, 2.0)
print(p1)        # Point(x=1.0, y=2.0, tags=[])
print(p1 == p2)  # True — auto-generated __eq__
print(p1.x)      # 1.0

@dataclass 从类型注解字段自动生成 __init__、__repr__、__eq__ 和 __hash__(当 frozen 时)。

常见混淆

  • 容易混淆的对象: 命名元组

    关键区别: 数据类默认可变且支持继承。命名元组始终不可变,是真正的元组(可索引),且占用更少内存。需要灵活性用数据类,需要不可变轻量记录用命名元组。

相关术语

相关资源

相关课程

解读错误信息

用大白话解释常见错误——什么意思、为什么发生、如何修复。

查看错误

← 返回术语表