@dataclass适用于仅存储和传递数据、无复杂逻辑的类，如API响应、配置参数、数据库记录或函数参数；需类型注解，支持默认值、frozen、order及field定制。

Python 的 @dataclass 是简化类定义的实用工具，它自动为你生成常见方法（如 __init__、__repr__、__eq__），让数据容器类写起来更简洁、可读性更强，也更少出错。

什么时候该用 @dataclass？

当你需要一个主要用来存储和传递数据的类，且不涉及复杂逻辑或行为封装时，@dataclass 就很合适。比如：

• API 响应解析后的结构化对象（如用户信息、订单详情）
• 配置参数集合（把多个相关配置项组织成一个类）
• 数据库记录映射（配合 ORM 或纯数据处理场景）
• 函数间传递的一组参数（替代字典或命名元组，更类型安全）

基础用法与默认行为

只需在类前加 @dataclass 装饰器，所有带类型注解的字段会自动参与初始化和表示：

<font color="#0066cc">from dataclasses import dataclass</font><p><font color="#0066cc">@dataclass</font>
class Person:
name: str
age: int
city: str = "Beijing"  # 支持默认值</p><p>p = Person("Alice", 28)
print(p)  # Person(name='Alice', age=28, city='Beijing')</p>

注意：字段必须有类型注解（Python 3.6+），否则不会被识别为 dataclass 字段；有默认值的字段要放在无默认值字段之后。

python全能编程助手

SkillSub Pro - Python 题解与代码注释双功能技能功能概述SkillSub Pro - Python 题解与代码注释双功能技能是一项面向实际任务的技能，主要用于SkillSub Pro 是一个 Python 题解生成与代码注释的 双功能合体技能 ，专为学生、算法学习者和开发者设计；✅ 一个技能，两种用途 ：；核心要点📝 题解模式 ：输入题目/题号，自动生成完整 Python 题解（含详细注释、解题思路、复杂度分析）；💬 注释模式 ：输入 Python 代码，自动添加详细中。它将相关步骤、

下载

立即学习“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__ 比较

例如：

<font color="#0066cc">from dataclasses import dataclass, field</font><p><font color="#0066cc">@dataclass</font>
class Book:
title: str
author: str
tags: list = field(default_factory=list)  # 安全的空列表
_id: int = field(init=False, repr=False)  # 不进初始化，也不显示在 repr 中</p>