Python dataclass该设为可哈希用于集合，还是用列表做去重校验？

核心前提 #

首先明确Python哈希规则的硬性要求：所有可存入set、作为dict键的对象，其哈希值必须在对象的整个生命周期内保持恒定，违反这个规则会出现元素找不到、集合去重失效等问题。

现有方案的问题 #

• 直接使用unsafe_hash=True：如果参与哈希计算的字段后续被修改，哈希值会同步变化，完全不符合上述规则，仅适合能100%保证相关字段永不修改的场景，初学者使用确实有较高风险。
• 用name、dob等业务字段计算哈希但后续需要修改字段：本质和上面的问题一致，修改业务字段后哈希值会变化，之前存入集合的实例会无法正常识别，完全不可行。

新增唯一ID的方案是合理且常用的工程方案 #

这个方案完美规避了可变字段影响哈希值的问题，实现逻辑如下：

1. 给类新增全局唯一且永不修改的ID字段，可以用UUID，如果你用的是SQLAlchemy模型，直接复用主键字段即可，无需额外新增。
2. 配置dataclass字段参数，仅让ID字段参与哈希计算，其余可变业务字段均设置为不参与哈希计算。
3. 相等判断逻辑可以根据你的业务需求灵活配置：如果要求ID相同即判定为同一对象，就仅让ID参与相等判断；如果要求业务字段也一致才判定相等，也可以把业务字段加入相等判断，只要保证相等的两个对象哈希值一定相等即可，不会违反Python的哈希规则。

示例代码 #

from dataclasses import dataclass, field
import uuid

@dataclass(eq=True)
class Person:
    # ID字段仅自动生成，不允许初始化传入，仅参与哈希和相等判断
    id: uuid.UUID = field(default_factory=uuid.uuid4, init=False, hash=True, eq=True)
    # 可变业务字段不参与哈希计算，是否参与相等判断可按需调整
    name: str = field(hash=False, eq=True)
    dob: str = field(hash=False, eq=True)

# 功能测试
p = Person(name="张三", dob="2000-01-01")
person_set = {p}
# 修改name字段后哈希值不变，依然可以正常从集合中找到
p.name = "张三新"
assert p in person_set

哈希值恒定的保证方法 #

只要确保所有参与__hash__计算的字段（上述示例中的ID字段）初始化完成后永远不会被修改即可：

• 配置字段的init=False参数，禁止实例化时手动传入ID，避免人为写错
• 业务代码中永远不要修改ID字段的值
• 如果是SQLAlchemy模型，主键本身就满足永不修改的要求，直接使用即可。

内容的提问来源于stack exchange，提问作者Joaquim