__missing__ 方法仅在继承 dict 且通过 d[key] 访问缺失键触发 KeyError 时调用,不响应 .get()、.pop() 或 in;必须显式继承 dict,参数仅为 self 和 key,返回值替代 KeyError;返回可变对象需手动缓存以防共享;不可与 defaultdict 混用。

__missing__ 方法只在继承 dict 且触发 KeyError 时才被调用
它不是“每次查不到键就执行”,而是仅当子类继承 dict、且使用 __getitem__(即方括号 [])访问缺失键时,Python 才会自动调用 __missing__。如果用 .get()、.pop() 或 in 判断,这个方法完全不会触发。
常见错误是以为它能接管所有“键不存在”的场景,结果写了 __missing__ 却发现 d.get('x') 还是返回 None,毫无反应。
- 必须显式继承
dict(不能只实现__getitem__) - 只能响应
d['key']这种语法,其他访问方式绕过它 -
__missing__必须有且仅有一个参数(self和key),返回值会直接作为__getitem__的结果
返回默认值 vs 抛出异常:取决于你的业务逻辑
__missing__ 的返回值会原样替代 KeyError,所以你可以返回任意类型——字符串、数字、新列表,甚至另一个字典。但要注意副作用:如果返回可变对象(如空列表),多次访问同一缺失键可能拿到同一个对象引用,导致意外共享。
class DefaultListDict(dict):
def __missing__(self, key):
self[key] = [] # ✅ 缓存到实例中,避免重复创建
return self[key]
<p>d = DefaultListDict()
d['a'].append(1)
d['a'].append(2)
print(d['a']) # [1, 2]
</p>
反例:直接 return [] 而不赋值,每次调用都返回新列表,无法累积数据。
别和 collections.defaultdict 混用或替代
defaultdict 是独立实现,默认工厂函数在 __getitem__ 内部调用,不依赖 __missing__;而你自定义的 __missing__ 类,如果又传给 defaultdict 构造,会因协议冲突出错。
更关键的是:defaultdict 在插入新键时就调用工厂函数(哪怕只是读取),而 __missing__ 只在读取失败时触发,且不自动设值——除非你在方法里手动写 self[key] = ...。
Python 环境工具专业版功能概述Python 环境工具专业版是一项面向实际任务的技能。它将相关步骤、工具调用和结果整理方式集中到统一流程中,帮助使用者更快完成目标并减少重复操作。核心要点使用时应结合输入条件选择合适的执行方式,核对必要参数、依赖环境与输出内容,并按原始要求处理异常情况。该技能适合需要稳定复用相关能力的场景,可作为自动化工作流的一部分,也便于后续检查、调整和扩展。执行完成后建议检查结果是否符合预期,并保留必要记录。使用与执行同时注意输入完整性、执行条件和输出可用性。从功能定位来看,该技能
- 需要“读即写”行为(比如懒初始化嵌套结构),用
__missing__更可控 - 只需要简单默认值(如
int、list),defaultdict更轻量、无歧义 - 两者不能混用:把自定义
dict子类传给defaultdict会报TypeError: first argument must be callable
调试时记得检查父类是否已定义 __missing__
内置 dict 没有 __missing__,所以子类只要定义了就会生效。但如果你继承的是第三方字典类(比如某些 ORM 的映射类),它可能自己实现了 __missing__ 并调用了 super().__missing__(key)——这时你的方法可能根本不会被执行。
最稳妥的验证方式是加一行日志:
def __missing__(self, key):
print(f"__missing__ called for {key!r}") # 看是否真被调用
return "fallback"
如果没输出,要么没走 [] 路径,要么父类拦截了,或者类没正确继承 dict。
真正容易被忽略的是:它只对直接继承 dict 有效,且仅绑定在 __getitem__ 这一条路径上。别的地方想复用逻辑,得手动调用或提取成普通方法——别指望它是个全局钩子。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!










