Python对象哈希方法\_\_hash\_\_详解

本文深入解析了Python中对象哈希机制的核心——`__hash__`方法，阐明了可哈希性的本质要求：相等对象必须拥有相同且生命周期内恒定的哈希值；系统详细对比了内置不可变类型（如int、str、tuple）默认可哈希与可变类型（如list、dict）默认不可哈希的差异，并手把手指导如何安全地为自定义类实现`__hash__`和`__eq__`，强调逻辑不可变性、属性冻结与方法协同的关键原则，同时揭露常见陷阱（如只写`__hash__`不重写`__eq__`、在哈希中使用可变状态）及主动禁用哈希的最佳实践，助你写出健壮、符合Python语义的哈希兼容代码。

Python 中的 __hash__ 方法决定了对象能否作为字典键或集合元素，核心在于：**可哈希对象必须满足“相等对象具有相同哈希值”，且哈希值在其生命周期内不可变**。

什么对象默认可哈希？

内置不可变类型（如 int、str、tuple、frozenset）默认实现了 __hash__，因此可直接用作字典键或加入集合；而可变类型（如 list、dict、set）默认不提供 __hash__，调用会抛出 TypeError。

自定义类如何支持哈希？

若希望自定义类实例可哈希，需同时满足两个条件：

• 显式定义 __hash__ 方法，返回一个整数
• 重写 __eq__ 方法（否则 Python 会使用默认的基于身份的比较，导致逻辑不一致）
• 确保参与比较和哈希计算的属性在对象创建后不再改变（即实例是逻辑不可变的）

例如：

class Point:
  def __init__(self, x, y):
    self._x = x
    self._y = y

  @property
  def x(self): return self._x
  @property
  def y(self): return self._y

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

  def __hash__(self):
    return hash((self.x, self.y)) # 基于不可变属性元组计算

常见陷阱与注意事项

以下做法会导致行为异常或报错：

• 仅实现 __hash__ 而不重写 __eq__：可能违反“相等对象哈希值相同”的契约
• 在 __hash__ 中使用可变属性（如普通实例变量未加保护）：对象修改后哈希值变化，破坏字典/集合内部结构
• 返回非整数（如字符串或浮点数）：引发 TypeError
• 对本应不可哈希的类返回 hash(self) 或 id(self)：虽能运行，但违背语义（不同但相等的对象哈希不同）

何时应禁用哈希？

如果类设计为可变（如允许后续修改属性），应显式将 __hash__ 设为 None：

def __hash__(self):
  return None # 等价于未定义 __hash__，明确表示不可哈希

这样能提前阻止误用，比运行时出错更清晰。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《Python对象哈希方法\_\_hash\_\_详解》文章吧，也可关注golang学习网公众号了解相关技术文章。