当前位置：首页 > 文章列表 > 文章 > python教程 > 如何让 hash 只在 frozen dataclass 上生效

如何让 hash 只在 frozen dataclass 上生效

2026-05-02 16:39:38 0浏览收藏

有志者，事竟成！如果你在学习文章，那么本文《如何让 hash 只在 frozen dataclass 上生效》，就很适合你！文章讲解的知识点主要包括，若是你对本文感兴趣，或者是想搞懂其中某个知识点，就请你继续往下看吧~

普通dataclass的hash为False，因为Python默认生成的__hash__为None；即使设hash=True，含可变字段（如list）时也会被静默忽略，因哈希值需在对象生命周期内恒定。

为什么普通 dataclass 的 hash 是 False

Python 默认给 @dataclass 生成的 __hash__ 方法是 None，哪怕你显式写 hash=True，只要类里有可变字段（比如 list、dict），解释器就会静默忽略它，最终实例仍是不可哈希的。根本原因在于：Python 要求哈希值在对象生命周期内恒定，而可变字段的内容随时可能变。

frozen=True 是必要条件，但还不够

frozen=True 会让 dataclass 把所有字段设为只读（背后调用 object.__setattr__ 拦截赋值），这是启用 hash 的前提。但仅加 frozen=True 不等于自动有 hash —— 你必须**同时指定 hash=None 或明确写 hash=True**，否则 Python 仍按默认逻辑推导（即：有可变字段 → 禁用 hash）。

✅ 正确：@dataclass(frozen=True, hash=True)
✅ 也行：@dataclass(frozen=True, hash=None)（此时会按字段类型自动推导 hash 行为）
❌ 错误：@dataclass(frozen=True)（hash 未显式设置，且字段含 list 等 → __hash__ = None）

字段类型决定 hash 是否真能用

即使加了 frozen=True 和 hash=True，如果某个字段本身不可哈希（例如 list、dict、自定义类没实现 __hash__），实例创建时不会报错，但调用 hash() 会立刻抛 TypeError: unhashable type。

常见修复方式：

把 list 改成 tuple（tuple 可哈希，前提是元素也都可哈希）
把 dict 改成 frozenset 或 tuple(sorted(dict.items()))
对自定义类，确保它有确定的 __hash__ 且不依赖可变状态

示例：

@dataclass(frozen=True, hash=True)
class Point:
    x: int
    y: int
    tags: tuple[str, ...]  # ✅ 可哈希
❌ 这样会 runtime 报错：hash(Point(1, 2, ["a"])) → TypeError
tags: list[str]