讲师中心 微信公众号
AI工具推荐 视频效率加速

为什么Python中重写__eq__后必须重写__hash__

夜磊君_8858

夜磊君_8858

发布时间:2026-11-04 08:57:30

|

588人浏览过

|

来源于php中文网

原创

Python 3中显式定义__eq__会自动将__hash__设为None,以防止可变对象被用作字典键或集合元素;若需哈希,必须基于不可变字段实现__hash__,且与__eq__逻辑一致。

为什么python中重写__eq__后必须重写__hash__

重写 __eq__ 后 __hash__ 被自动设为 None

Python 3 的设计规则是:只要类显式定义了 __eq__,解释器就认为该类的实例“可能可变”,于是**自动将 __hash__ 设为 None**。这不是警告,是硬性禁用:

  • 此时尝试把实例放进 set、作为 dict 的键、或传给 hash(),会立刻报 TypeError: unhashable type
  • 哪怕你没动 __hash__,它也不再继承 object.__hash__(即基于 id 的默认哈希)
  • 这个行为无法绕过——不是忘了写,是 Python 主动把它“关掉”了

__hash__ 和 __eq__ 必须逻辑一致

哈希表(dict/set 底层)依赖两步定位:

  • 先调 hash(obj) 算出桶号
  • 再在桶内遍历,对每个候选对象调 obj == candidate 做最终确认

如果只重写 __eq__ 而不改 __hash__,就会出现:

  • a == b 返回 True(字段相同)
  • 但 hash(a) != hash(b)(因为 __hash__ 还是默认的 id 基础)
  • 结果:a in {b} 是 False,{a, b} 长度为 2,{a: 1, b: 2} 是两个键

怎么写安全的 __hash__?只基于不可变字段

核心约束只有一个:所有参与 __eq__ 判断的字段,也必须参与 __hash__ 计算;且这些字段在对象生命周期内不能被修改。

Python Pep Authoring
Python Pep Authoring

依据官方 python/peps仓库规则起草、审阅、编辑或准备 Python 改进提案(PEP),用于处理 PEP 文本和元数据头部。

下载

立即学习“Python免费学习笔记(深入)”;

  • 推荐写法:def __hash__(self): return hash((self.x, self.y)) —— 元组天然不可变,hash 安全
  • 如果类本身可变(比如有 self.cache 或 self.updated_at),别强行哈希;要么冻结字段(@dataclass(frozen=True)),要么设 __hash__ = None 显式拒绝
  • 绝对不要在 __hash__ 中调用方法、读取属性 getter、或引入随机数/时间戳——哈希值必须稳定

最容易被忽略的细节:字段可变性比代码写法更关键

即使你写了 __hash__ = lambda self: hash(self.x) 且 __eq__ 也只比 x,只要 self.x 后续被修改,哈希表就失效:

  • 对象插入 set 后,self.x 从 1 改成 2
  • 再查 obj in my_set 可能返回 False,因为桶位置已错
  • 这种 bug 很难复现,往往出现在长期运行的服务中

所以真正决定能否哈希的,不是你有没有写 __hash__,而是你的对象是不是事实上的值对象(value object)——字段初始化后就不再变化。

热门AI工具

更多
豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

创客贴AI

创客贴AI是一款AI图像与设计工具,AI辅助的智能在线设计工具。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

相关专题

更多
python打包成可执行文件
python打包成可执行文件

本专题为大家带来python打包成可执行文件相关的文章,大家可以免费的下载体验。

1871

2023.07.20

python能做什么
python能做什么

python能做的有:可用于开发基于控制台的应用程序、多媒体部分开发、用于开发基于Web的应用程序、使用python处理数据、系统编程等等。本专题为大家提供python相关的各种文章、以及下载和课程。

5064

2023.07.25

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

1809

2023.07.31

python教程
python教程

Python已成为一门网红语言,即使是在非编程开发者当中,也掀起了一股学习的热潮。本专题为大家带来python教程的相关文章,大家可以免费体验学习。

30537

2023.08.03

python环境变量的配置
python环境变量的配置

Python是一种流行的编程语言,被广泛用于软件开发、数据分析和科学计算等领域。在安装Python之后,我们需要配置环境变量,以便在任何位置都能够访问Python的可执行文件。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

3627

2023.08.04

python eval
python eval

eval函数是Python中一个非常强大的函数,它可以将字符串作为Python代码进行执行,实现动态编程的效果。然而,由于其潜在的安全风险和性能问题,需要谨慎使用。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

3647

2023.08.04

scratch和python区别
scratch和python区别

scratch和python的区别:1、scratch是一种专为初学者设计的图形化编程语言,python是一种文本编程语言;2、scratch使用的是基于积木的编程语法,python采用更加传统的文本编程语法等等。本专题为大家提供scratch和python相关的文章、下载、课程内容,供大家免费下载体验。

1243

2023.08.11

python合并两个列表
python合并两个列表

Python是一种强大的编程语言,具有许多方便的功能和工具。在Python中,有多种方法可以合并两个列表。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

616

2023.08.10

Docker Desktop怎么设置端口映射
Docker Desktop怎么设置端口映射

本专题聚焦Docker Desktop容器端口映射与访问配置,整理从创建容器、设置端口绑定到验证本地服务访问的操作流程。针对端口被占用、映射配置错误、容器服务无法访问等情况,也提供相应的检查方向,方便用户完成端口配置。

0

2026.11.03

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn