__missing__仅在d[key]触发keyerror时调用,不响应.get()、in、setdefault()等操作;需继承dict并确保只在中括号取值且键不存在时生效。

直接说结论:用 __missing__ 可以让自定义字典类在 dict[key] 查不到键时自动触发逻辑,但它**只对中括号取值生效,不响应 .get()、in、.keys() 等操作**——这点最容易被忽略。
为什么 __missing__ 没被调用?
常见错误是以为它像默认值一样“兜底所有访问”,其实它只在 __getitem__ 内部显式抛出 KeyError 后才被调用。标准 dict 子类必须继承 dict(不是 collections.UserDict),且仅当使用 d[key] 语法且键不存在时触发。
-
d.get("x"):完全绕过__missing__,返回None或传入的默认值 -
"x" in d:调用__contains__,不走__missing__ -
d.setdefault("x", 42):内部先查键,查不到才设值,也不触发__missing__
正确实现一个带缺省计算的字典类
继承 dict,重写 __missing__,返回你想动态生成的值(不能抛异常,否则会暴露给上层):
class DefaultCalcDict(dict):
def __missing__(self, key):
# 这里可以做任意逻辑:查数据库、调 API、算哈希……
if isinstance(key, str) and key.startswith("calc_"):
result = len(key) * 2
self[key] = result # 可选:缓存结果
return result
raise KeyError(key) # 不匹配规则的键仍报错
注意:self[key] = result 这一行会触发再次调用 __setitem__,但不会递归进 __missing__;如果想避免重复计算,缓存是合理选择。
__missing__ 和 defaultdict 的关键区别
两者都能处理缺失键,但机制和适用场景不同:
-
defaultdict在构造时就绑定一个 callable(如list、int),每次缺键都无参调用它,**无法感知键本身** -
__missing__接收key参数,能根据键名、类型、甚至外部状态做差异化响应,**更灵活,但也更重** -
defaultdict是dict子类,但它的__missing__是 C 层实现的,你无法通过继承它再覆盖自己的__missing__——得自己继承dict
真正要用好 __missing__,得清楚它只是 __getitem__ 的一个钩子,不是万能代理。一旦涉及 .get() 或批量检查,就得手动补逻辑——这才是实际项目里最常掉坑的地方。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!











