如何在Python中通过__eq__和__hash__使对象可哈希-Python教程-PHP中文网

必须重写__hash__，因为重写__eq__后Python自动设__hash__为None以保证哈希一致性；安全做法是仅基于不可变且参与__eq__判断的属性用hash((a,b,c))计算。

如何在python中通过__eq__和__hash__使对象可哈希

为什么定义了 `eq` 还要重写 `hash`？

Python 默认让自定义类实例不可哈希（TypeError: unhashable type），哪怕你只改了 __eq__。因为 Python 要求：如果两个对象 __eq__ 返回 True，它们的 __hash__ 必须相等；反之，如果 __hash__ 不同，__eq__ 就不该返回 True。一旦你重写了 __eq__，Python 就自动把 __hash__ 设为 None，强制你显式定义它，避免违反哈希一致性。

怎么写一个安全的 `hash`？

核心原则：只基于那些参与 __eq__ 判断、且**不可变**的属性来计算哈希值。否则对象放进 set 或作为 dict 键后，属性一改，哈希值就变，导致查不到、重复插入、甚至破坏哈希表结构。

用 hash((a, b, c)) 对元组求哈希——最常用、最稳妥，前提是 a、b、c 本身可哈希且不变
不要用 id(self) 或随机数——这会让相等对象哈希不同，违背约定
不要在 __hash__ 里访问可变属性（比如列表、字典），哪怕它们参与了 __eq__ ——运行时可能报 TypeError 或逻辑错乱
如果类设计上允许修改关键字段，就别让它可哈希；真要支持，得靠 __slots__ + 属性冻结，或手动抛 TypeError 在 setter 里

`eq` 和 `hash` 的典型配对写法

以一个表示二维点的类为例：

class Point:
    __slots__ = ('x', 'y')  # 防止动态加属性，强化不可变语义
<pre class="brush:php;toolbar:false;">def __init__(self, x, y):
    self.x = x
    self.y = y

def __eq__(self, other):
    if not isinstance(other, Point):
        return False
    return self.x == other.x and self.y == other.y

def __hash__(self):
    return hash((self.x, self.y))

注意三点：

librosa Python 音频与音乐分析库

librosa 是一个用于音频和音乐分析的 Python 库。它提供了特征提取、频谱分析、节拍跟踪、起始检测和音频可视化的工具，基于 NumPy 和 SciPy 构建，用于科学音频计算。

下载

__slots__ 不是必须的，但它能阻止意外赋值，配合文档说明“此对象应视为不可变”，减少误用
__eq__ 里做了类型检查，避免和非 Point 对象比较时出错（比如 Point(1,2) == [1,2] 返回 False 而不是抛异常）
如果 x 或 y 是浮点数，要考虑精度问题：0.1 + 0.2 != 0.3，这时候 __eq__ 可能需要 math.isclose，但 __hash__ 仍得用原始值——否则哈希不一致。这种场景下，干脆别让它可哈希

常见错误：可变对象强行哈希

下面这段代码看着能跑，但极其危险：

class BadContainer:
    def __init__(self, items):
        self.items = items  # list，可变
<pre class="brush:php;toolbar:false;">def __eq__(self, other):
    return self.items == other.items

def __hash__(self):
    return hash(tuple(self.items))  # ❌ 危险！items 可能被外部修改

一旦你把它放进 set，再修改 items，这个对象在集合里的位置就“找不到了”：