@dataclass适用于仅存储和传递数据、无复杂逻辑的类，如API响应、配置参数、数据库记录或函数参数；需类型注解，支持默认值、frozen、order及field定制。
python 的 @dataclass 是简化类定义的实用工具，它自动为你生成常见方法（如 __init__、__repr__、__eq__），让数据容器类写起来更简洁、可读性更强，也更少出错。
什么时候该用 @dataclass？
当你需要一个主要用来存储和传递数据的类，且不涉及复杂逻辑或行为封装时，@dataclass 就很合适。比如：
- API 响应解析后的结构化对象（如用户信息、订单详情）
- 配置参数集合（把多个相关配置项组织成一个类）
- 数据库记录映射（配合 ORM 或纯数据处理场景）
- 函数间传递的一组参数（替代字典或命名元组，更类型安全）
基础用法与默认行为
只需在类前加 @dataclass 装饰器，所有带类型注解的字段会自动参与初始化和表示：
from dataclasses import dataclass@dataclass class Person: name: str age: int city: str = "Beijing" # 支持默认值
p = Person("Alice", 28) print(p) # Person(name='Alice', age=28, city='Beijing')
注意：字段必须有类型注解（Python 3.6+），否则不会被识别为 dataclass 字段；有默认值的字段要放在无默认值字段之后。
立即学习“Python免费学习笔记（深入）”；
常用参数与进阶控制
@dataclass 支持多个参数来调整行为：
-
init=False：不自动生成__init__，适合只做数据容器、由其他方式构造实例 -
repr=False：关闭自动生成的__repr__，避免敏感字段暴露 -
eq=False：禁用自动__eq__，适用于需要自定义相等逻辑的场景 -
frozen=True：让实例不可变（类似namedtuple），赋值会报错 -
order=True：额外生成__lt__等比较方法，支持排序（需所有字段可比较）
字段级定制：field() 函数
用 field() 可对单个字段做精细控制：
-
default/default_factory：设置默认值，后者用于可变对象（如list、dict） -
init=False：该字段不参与__init__，但保留在实例中（适合运行时计算字段） -
repr=False：该字段不出现在__repr__输出里（如密码、Token） -
compare=False：该字段不参与__eq__或__lt__比较
例如：
from dataclasses import dataclass, field@dataclass class Book: title: str author: str tags: list = field(default_factory=list) # 安全的空列表 _id: int = field(init=False, repr=False) # 不进初始化，也不显示在 repr 中