Python dataclasses 怎样让字段不参与比较

如果一个 dataclass 同时保存业务身份和运行时状态，默认比较可能会把两类字段混在一起。例如订单的 order_id 相同，但缓存时间不同，两个对象仍然被判断为不相等。解决方法是给不属于对象身份的字段设置 field(compare=False)：字段仍然存在、仍可初始化和访问，但不会进入 dataclass 自动生成的相等与排序比较方法。

这篇只讨论字段比较行为。核心规则是：默认 compare=True，字段会参与 __eq__；设置为 False 后，它也不会参与 order=True 生成的排序方法。

先区分相等比较和排序比较

@dataclass 默认生成 __eq__，但不会默认生成小于、大于等排序方法。自动比较只针对同一个 dataclass 类型，并按字段定义顺序读取参与比较的字段。不要把“对象里有这个属性”误解成“这个属性一定属于对象身份”。

from dataclasses import dataclass

@dataclass
class Task:
    # 任务编号决定业务身份，默认参与相等比较
    task_id: int
    # 当前状态是业务字段，也会影响相等结果
    state: str
    # 默认 compare=True，展示名变化也会影响相等结果
    label: str

在这个定义中，Task(7, "ready", "导入") 和 Task(7, "ready", "批量导入") 不相等，因为三个字段都在比较集合里。先画清字段职责，才能决定是否排除。

用 field(compare=False) 排除辅助字段

把不代表业务身份的字段改成 field(compare=False)。它不会删除字段，也不会阻止构造函数接收参数；它只改变 dataclass 生成比较方法时采用的字段集合。

from dataclasses import dataclass, field

@dataclass
class Task:
    # 这两个字段共同决定任务是否是同一个业务对象
    task_id: int
    state: str
    # 调试信息保留在对象中，但不影响 __eq__
    trace_id: str = field(compare=False, default="")

left = Task(7, "ready", trace_id="trace-a")
right = Task(7, "ready", trace_id="trace-b")
print(left == right)  # True：只比较 task_id 和 state

这里的关键不是字段名字，而是字段语义。请求追踪号、最近刷新时间、缓存命中标记等通常是观测信息；如果它们变化不应让对象身份变化，就适合排除。相反，如果状态本身是业务状态，就应保留在比较集合里。

打开 order=True 时检查排序语义

如果声明 @dataclass(order=True)，Python 会额外生成 __lt__、__le__、__gt__ 和 __ge__。这些方法同样只使用 compare=True 的字段，并按字段顺序形成排序键。

from dataclasses import dataclass, field

@dataclass(order=True)
class Job:
    # 排序先看优先级，再看创建序号
    priority: int
    sequence: int
    # 这类调度备注不应改变排序位置
    note: str = field(compare=False, default="")

first = Job(10, 3, note="来自重试队列")
second = Job(10, 3, note="人工补录")
print(first == second)  # True：note 不参与相等比较
print(first 

排序字段仍必须能彼此比较；不要用 compare=False 掩盖真正的排序规则。如果多个对象在参与比较的字段上完全相同，它们会得到相同的排序关系，业务上需要稳定次序时应增加明确的序号字段。

用字段职责检查设计

可以把字段分成三类：决定对象身份的字段、决定业务排序的字段、只服务于展示或观测的字段。前两类通常保留 compare=True，最后一类才考虑 compare=False。若一个字段既不参与比较又不应被构造函数传入，还要另行考虑 init=False，不要把两个选项混为一谈。

还要留意哈希和可变字段。compare=False 只描述比较集合，不等于对象自动可哈希，也不代表字段可以安全地放进集合键。是否冻结对象、是否生成哈希，应根据对象的可变性和业务不变量单独设计。

常见问题

compare=False 会让字段消失吗？

不会。字段仍然可以通过构造函数传入，也能被读取和修改；它只是被排除在 dataclass 自动生成的比较方法之外。

只想排除相等比较，仍想参与排序怎么办？

field(compare=...) 是一组开关，不能单独为 __eq__ 和排序方法指定不同的字段集合。若两者语义确实不同，应显式实现比较方法，或拆分对象职责，避免让自动生成规则表达不清。

因此，最稳妥的做法是先写出对象身份和排序键，再用 compare=False 排除纯观测字段；涉及哈希、可变性或不同比较语义时，再决定是否需要自定义方法。