Python dataclass 的 compare=False：备注明明不同，为什么两个对象仍然相等
给任务记录增加处理备注后，两份对象的备注一份是queued、一份是finished，放进集合却只剩一个位置。如果备注字段声明了compare=False，这个结果正符合生成的相等规则。读者需要先确定自己比较的是任务身份，还是任务的完整状态。
本文在CPython 3.12.14实跑，只创建少量内存对象。保存为demo.py，运行python3 demo.py。JobKey把project和number作为身份字段；note仍是正常字段，只从自动生成的比较中排除。示例使用冻结数据类，方便同时观察集合中的去重结果。
AI模型生成概念插图：两张主体相同、附注不同的卡片进入同一个匹配框，比喻辅助字段不参与相等判断；不是程序截图。
完整程序与本地结果
完整可运行程序
from dataclasses import dataclass, field, asdict
@dataclass(frozen=True)
class JobKey:
project: str
number: int
note: str = field(compare=False)
@dataclass(frozen=True)
class OtherKey:
project: str
number: int
note: str = field(compare=False)
first = JobKey("demo", 7, "queued")
second = JobKey("demo", 7, "finished")
assert first == second and first is not second
assert hash(first) == hash(second)
assert len({first, second}) == 1
assert asdict(first) != asdict(second)
print("equal / same object:", first == second, first is second)
print("set size:", len({first, second}))
print("notes remain:", asdict(first)["note"], asdict(second)["note"])
other = OtherKey("demo", 7, "queued")
assert first != other
assert JobKey.__eq__(first, other) is NotImplemented
print("other dataclass equal:", first == other)
@dataclass(frozen=True)
class FullRecord:
project: str
number: int
note: str
assert FullRecord("demo", 7, "queued") != FullRecord("demo", 7, "finished")
print("compare note when required:",
FullRecord("demo", 7, "queued") == FullRecord("demo", 7, "finished"))本地实际输出（以下内容为程序结果）
equal / same object: True False set size: 1 notes remain: queued finished other dataclass equal: False compare note when required: False
先把相等与完整内容分开
第一行的True False分别来自相等比较和对象身份比较。first与second是两个独立实例，但参与比较的project、number一致，所以自动生成的相等方法认为它们相等。note不同不会推翻这个结论，因为字段明确选择了compare=False。
下一行集合大小为1。默认hash设置会跟随字段的compare选择；本例冻结且启用相等比较，因此获得一致的散列行为。代码验证相等对象的哈希一致，却不打印具体哈希值，因为字符串哈希数值可能随进程变化。相同哈希也不能反过来证明对象相等。
排除比较不等于删除字段
notes remain仍显示queued和finished，asdict得到的完整快照也不同。compare=False没有把note从构造参数、实例数据或序列化字段清单里移走。若把对象用作集合成员或字典键，业务就已经接受不同备注共享同一个身份位置。
这种设计适合把请求编号与跟踪信息分开，例如同一任务的显示标签不影响去重。若备注变化应当代表不同业务版本，则应保留默认compare=True，或把版本字段明确纳入身份。不能靠调整比较设置去掩盖本来应该保留的记录差异。
字段一样仍要经过类型边界
OtherKey声明了同样的字段，输出却为False。数据类生成的相等方法要求两端类型完全相同；直接调用JobKey.__eq__得到NotImplemented，表示这一方法不负责该类型组合。最终的双边比较协议没有找到相等结果，表达式才返回False。
这有助于避免把两个不同领域的编号对象误认为同一事物，例如仓库任务号与客服任务号都等于7。需要跨类型比较时，最好显式提取共同的业务键，而不是假定字段名相同就自然相等。不要把NotImplemented误读为抛出了NotImplementedError。
把身份规则写成可维护的约定
最后的FullRecord让note恢复默认参与比较，queued与finished对应的对象就不再相等。维护时可将这组正反例留在测试里，覆盖同身份不同备注、不同身份、不同类型和完整状态比较，防止后来新增字段无意改变去重行为。
frozen约束的是普通字段赋值，不是把任意嵌套对象都变成不可变对象。本例仅使用字符串和整数。若将可变列表纳入比较或散列，必须重新设计键的稳定性；也不要为了让集合接受对象就随手启用unsafe_hash。身份字段在键存活期间应保持稳定。
补齐容易遗漏的验收条件
展示开关也不能代替比较开关。把note设成repr=False，只会让默认的调试表示不再打印它；只要compare仍为真，它仍影响相等。反过来，本例的note参与默认表示，却不参与比较。检查问题时应查看字段声明，不能只比较终端打印出来的两行对象。
如果一个类型需要同时支持多种比较口径，不一定要把某一种口径写进整个类型的相等方法。可以在去重入口显式生成(project, number)元组，在审计入口比较完整记录。这样身份比较与状态比较各有名称，调用者更容易知道某次合并依据了什么。
还有一个边界值得检查：若同一数据类的所有字段都排除比较，自动生成的相等逻辑就没有任何字段差异可以检查，同类型实例容易全部相等。为每个身份字段至少准备一组只改变该字段的反例，比仅用两个相同样本验证更能发现误配。
参考资料
资料核验日期：2026年10月2日。以上输出来自固定输入的本地实跑，退出码为0。
