python自定义对象相等比较需正确实现__eq__和__hash__方法:__eq__须满足自反性、对称性、传递性,__hash__须与__eq__一致,可变对象应设__hash__=none,不可变对象按参与比较的字段计算哈希。

Python中自定义对象的相等比较,核心是正确实现 __eq__ 方法。它不只决定 == 的行为,还直接影响字典键、集合去重等场景——写错会导致逻辑隐蔽出错,比如两个“相同”的对象无法在集合中去重,或作为字典键被当成不同项。
必须同时重写 __hash__(除非明确不可哈希)
如果类实现了 __eq__ 但没定义 __hash__,实例会自动变为不可哈希(hash(obj) 报错),无法放入 set 或用作 dict 键。常见错误是只改 __eq__ 忘了处理哈希:
- 若对象逻辑上可变(如含列表、字典等可变属性),应显式设
__hash__ = None,禁用哈希 - 若对象逻辑不可变(如只含 int、str、tuple 等),按参与比较的字段计算哈希,例如:
return hash((self.id, self.name)) - 确保
a == b为 True 时,hash(a) == hash(b)也必须为 True,否则破坏哈希容器语义
比较逻辑要严格遵循对称性、传递性与自反性
__eq__ 返回布尔值,但需满足数学上的等价关系规则,否则可能引发意外行为(如 set([a, b, c]) 中重复元素未被去重):
- 自反性:
a == a必须返回True(除非 a 是 NaN,但自定义类一般不涉及) - 对称性:若
a == b为 True,则b == a也必须为 True —— 建议开头检查isinstance(other, type(self)),不是同类直接返回False,避免反向调用出错 - 传递性:若
a == b且b == c,则a == c应为 True —— 这要求你选择的比较字段具有一致性,例如不要混合用 ID 比较和内容比较
避免递归比较与隐式类型转换
常见陷阱包括用 == 比较自身属性时触发无限递归,或对 None、空字符串等做模糊判断:
立即学习“Python免费学习笔记(深入)”;
- 不要在
__eq__中调用other == self,这会再次进入__eq__导致死循环 - 不建议把
""和None视为相等,除非业务强要求;更安全的做法是显式判断字段是否为None或空值,并统一处理 - 浮点数慎用
==直接比较,应改用math.isclose()并封装进比较逻辑(注意:这会使对象失去哈希能力,因 isclose 不满足精确等价)
推荐写法模板(带类型检查与字段聚焦)
以下是一个稳健的 __eq__ 实现示例:
def __eq__(self, other):
if not isinstance(other, MyClass):
return False
if self is other:
return True
return (self.id == other.id and
self.name == other.name and
self.status == other.status)
其中 self is other 是快速路径优化,避免重复字段比较;所有参与比较的字段都应纳入 __hash__ 计算,且保证不可变。










