Python eq 重载带来的隐藏问题

__eq__方法不返回布尔值会导致逻辑错误，因==期望true/false，返回none、0等会因真值判断引发意外分支；未实现__hash__则对象不可哈希；忽略is判断降低性能；访问不存在属性应返回notimplemented而非抛错。

__eq__ 方法不返回布尔值会出什么问题

python 的 == 运算符底层调用 __eq__，但它**期望返回 True 或 False**。如果返回其他类型（比如 None、整数、自定义对象），结果可能意外为 True 或 False，甚至引发逻辑错乱。

• 常见错误现象：obj1 == obj2 返回 0 或 []，却让 if obj1 == obj2: 意外进入分支（因为 Python 把非空容器、非零数当真值）
• 典型场景：重载时忘了写 return True / return False，只写了 print(...) 或直接结束函数（隐式返回 None）
• 实操建议：在 __eq__ 末尾加类型检查，比如 assert isinstance(result, bool), f"__eq__ must return bool, got {type(result)}"（仅开发期）

没同时实现 __hash__ 就用作字典键或集合元素

只要重载了 __eq__，且类实例要放进 set、当 dict 的 key，就必须显式定义 __hash__ —— 否则对象自动变成不可哈希（TypeError: unhashable type）。

• 常见错误现象：set([obj1, obj2]) 报错 TypeError: unhashable type: 'MyClass'，但单独 obj1 == obj2 却正常
• 参数差异：如果 __eq__ 依赖可变属性（如 self.name），__hash__ 就不能基于它；否则违反“相等对象必须有相同 hash”原则
• 实操建议：若对象逻辑上应不可变，用 @Property + 私有字段控制；若必须可变，干脆把 __hash__ = None，明确禁止哈希使用

继承父类 __eq__ 时忽略 is 判断导致性能问题

很多自定义类会先判断 other is self 再做字段比较，这是关键优化。跳过它，哪怕两个变量指向同一对象，也会触发完整字段比对，尤其在循环或大数据量下明显拖慢。

• 常见错误现象：重载 __eq__ 时只写 return self.x == other.x and self.y == other.y，没前置 if other is self: return True
• 使用场景：高频比较（如图算法中节点判重、缓存 key 查找）
• 性能影响：单次影响微小，但叠加后可能让 O(n) 变成 O(n²)，尤其在 list.index() 或 in 操作中反复触发

__eq__ 中访问不存在属性没处理 AttributeError

当 other 不是本类实例（比如拿 str 或 int 和你的对象比），__eq__ 里直接访问 other.xxx 会抛 AttributeError，而 Python 会把它静默转成 False —— 表面看“没报错”，实际掩盖了类型误用。

立即学习“Python免费学习笔记（深入）”；

• 常见错误现象：my_obj == "hello" 返回 False，但你根本没想支持字符串比较，只是漏了类型检查
• 实操建议：开头加 if not isinstance(other, self.__class__): return NotImplemented（注意不是 False！）让 Python 尝试调用 str.__eq__ 回退逻辑，更符合预期
• 为什么用 NotImplemented：它是特殊单例，告诉 Python “我处理不了，请换别的方法”，而 False 是确定性结果，会跳过所有后续尝试

最麻烦的不是写错 __eq__，而是它“看起来工作正常”——比如返回 None 却被当成 False，或者漏掉 is 判断只在数据量大时才暴露卡顿。这些都得靠针对性断言和边界测试才能揪出来。