@dataclass适用于纯数据容器场景：字段均为普通类型、无需运行时校验、不依赖动态默认值或复杂初始化；需用default_factory避免可变默认值陷阱，frozen=true仅浅层冻结，继承时注意__init__覆盖问题。
dataclass 能省掉大量样板代码，但不是所有场景都适合直接替换——它默认不支持可变默认值、不能自动处理嵌套数据验证，且继承行为和普通类有差异。
什么时候该用 @dataclass 而不是手写 __init__
当你定义的类主要只做「存数据」，没有复杂初始化逻辑、不依赖实例方法改变内部状态、也不需要对字段做运行时校验时，@dataclass 是最直接的替代方案。
- 字段全是普通类型（
int、str、list、dict等），且不需要在赋值时转换或检查 - 不需要自定义
__repr__或__eq__行为（默认已生成） - 不打算给字段设动态默认值（比如
default=list会报错，得用default_factory=list） - 不依赖
__post_init__做额外初始化（除非你明确需要它）
default 和 default_factory 容易踩坑
用 default 给可变对象（如 list、dict）设默认值会导致所有实例共享同一对象——这是 Python 常见陷阱，在 @dataclass 里同样存在，且错误更隐蔽。
正确写法必须用 default_factory：
@dataclass
class User:
name: str
tags: list = field(default_factory=list) # ✅
config: dict = field(default_factory=dict) # ✅
# tags: list = [] # ❌ 运行时报 warning，实际会出 bug
需要浅层不可变性时，别只靠 frozen=True
frozen=True 只冻结实例属性本身（禁止 obj.x = ...），但不递归冻结嵌套对象。如果字段是 list 或自定义类，默认仍可被原地修改。
-
frozen=True后，__slots__自动启用，内存更省，但类不再支持动态加属性 - 若字段含可变对象（如
list），需手动用tuple替代，或在__post_init__中转成不可变类型 - 继承自 frozen dataclass 的子类也必须声明
frozen=True，否则报错
和普通类混用时注意 __init__ 覆盖逻辑
如果父类已有 __init__，而子类加了 @dataclass，Python 不会自动调用父类 __init__ —— @dataclass 生成的 __init__ 会完全覆盖它。
- 解决办法：子类不加
@dataclass，改用field(init=False)配合手动__post_init__ - 或者父类也用
@dataclass，并确保所有字段都在 dataclass 字段列表中显式声明 - 混合使用时，
__post_init__是唯一可靠的“初始化后钩子”，比手写__init__更安全
真正省代码的前提是接受它的约束：它优化的是“数据容器”这一特定模式，而不是通用类建模。一旦开始往里面塞业务逻辑、状态变更或深度校验，就该停下来想想——是不是该拆成 dataclass + service class 了。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
