python中对象不可哈希的根本原因是未实现__hash__方法或返回非法值，深层原因在于可变性与哈希要求的不变性冲突；哈希要求同一对象多次hash结果相同，且相等对象哈希值必须相等。
Python中对象不可哈希，根本原因在于它**没有实现 __hash__ 方法**，或该方法返回了不合法值（如 None），更深层的原因是其**可变性与哈希要求冲突**——哈希值必须在对象生命周期内保持不变，而可变对象的值可能随时改变。
哈希的核心要求：一致性与不变性
一个对象要可哈希，必须满足两个硬性条件：
-
同一对象多次调用
hash()必须返回相同整数（即使跨解释器重启，只要没重载__hash__，CPython 中也尽量保持稳定）； -
如果两个对象相等（
a == b为True），它们的哈希值必须相等（即hash(a) == hash(b)）。
这两条合起来，意味着哈希值只能依赖对象的“不可变状态”。一旦对象内容能被修改（比如列表追加元素、字典更新键值），就无法保证哈希值恒定——否则会导致字典/集合内部索引错乱，出现查找失败或数据丢失。
为什么 list、dict、set 默认不可哈希？
因为它们是典型的可变容器：
立即学习“Python免费学习笔记（深入）”；
-
list没有定义__hash__，直接调用hash([1,2])抛出TypeError； -
dict和set同理，且它们的底层实现依赖哈希表，自身若可哈希会引发逻辑矛盾（比如把一个 dict 当作另一个 dict 的 key，随后修改原 dict，就再也找不到它了）； - 相反，
tuple可哈希——前提是其所有元素都可哈希（(1, [2])不可哈希，因为含不可哈希的 list）。
自定义类如何支持哈希？关键三步
要让自定义类实例可哈希，需同时满足：
- 实现
__hash__(self)，返回一个整数（通常基于不可变属性计算）； - 实现
__eq__(self, other)，确保相等判断逻辑与哈希逻辑一致； -
确保参与哈希计算的属性在对象创建后不再改变（推荐设为只读，或不在
__hash__中使用可变字段）。
例如：
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)) # 基于不可变属性元组
不可哈希 ≠ 不能用作字典键的唯一障碍
即使对象可哈希，也不代表适合当键：
- 哈希冲突仍会发生，只是 Python 能处理；
- 若
__eq__实现不合理（如总是返回True），会导致所有实例被当作同一个键； - 过度复杂的
__hash__（如涉及 I/O 或随机数）会破坏哈希稳定性，引发难以调试的问题。
设计时优先考虑语义：这个对象的“身份”是否天然由某些固定字段决定？如果是，再赋予哈希能力；否则，保持不可哈希更安全。
