python中可哈希对象需满足“相等对象哈希值相同”且哈希值生命周期内不可变；内置不可变类型（如int、str、tuple）默认可哈希，可变类型（如list、dict）默认不可哈希；自定义类需同时实现__hash__和__eq__方法，并确保参与哈希的属性逻辑不可变。
Python 中的 __hash__ 方法决定了对象能否作为字典键或集合元素，核心在于：**可哈希对象必须满足“相等对象具有相同哈希值”，且哈希值在其生命周期内不可变**。
什么对象默认可哈希？
内置不可变类型（如 int、str、tuple、frozenset）默认实现了 __hash__，因此可直接用作字典键或加入集合；而可变类型（如 list、dict、set）默认不提供 __hash__，调用会抛出 TypeError。
自定义类如何支持哈希？
若希望自定义类实例可哈希，需同时满足两个条件：
- 显式定义
__hash__方法，返回一个整数 - 重写
__eq__方法（否则 Python 会使用默认的基于身份的比较，导致逻辑不一致） - 确保参与比较和哈希计算的属性在对象创建后不再改变（即实例是逻辑不可变的）
例如：
立即学习“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__，明确表示不可哈希
这样能提前阻止误用，比运行时出错更清晰。
