__missing__ 方法仅适用于继承 dict 的子类，用于在 d[key] 查找失败时返回自定义值，不响应 .get()、in、.pop() 等操作，且不影响 update() 和字面量初始化。
__missing__ 方法只能用于继承 dict 的子类
__missing__ 不是普通字典的内置行为，直接对 dict 实例赋值或调用它无效。必须定义一个类，继承 dict，并在其中实现该方法。Python 在执行 d[key] 且 key 不存在时，才会自动触发 __missing__（前提是类没重写 __getitem__）。如果用了 .get(key) 或 in 判断，__missing__ 完全不会被调用。
- 错误写法：
d = {}然后试图给它加__missing__—— 不生效 - 正确结构：必须是
class AutoConvertDict(dict):并在内部定义def __missing__(self, key): - 注意：不能依赖
__missing__来拦截.pop()、.setdefault()等方法，它们各自有独立逻辑
键名自动转换的典型场景：大小写/下划线/驼峰统一
比如 API 返回字段是 user_name，但代码里习惯用 userName；或配置项允许 "DEBUG" 和 "debug" 同时生效。这时可在 __missing__ 中尝试多种规范化形式查找：
class CaseInsensitiveDict(dict):
def __missing__(self, key):
# 先试小写
if isinstance(key, str):
for k in self:
if isinstance(k, str) and k.lower() == key.lower():
return self[k]
raise KeyError(key)
- 只对
str类型做转换，避免对int、tuple等误处理 - 查不到就
raise KeyError(key)，保持和原生dict行为一致；返回默认值（如None）会掩盖真实缺失问题 - 性能敏感场景慎用：每次 miss 都要遍历所有键，O(n) 开销；高频访问建议预建映射表（如额外维护
self._lower_map）
__missing__ 无法覆盖 dict.update() 和字面量初始化
如果你希望 update() 传入的键也自动转换，__missing__ 完全无能为力——它只响应读取操作。同样，{'User_Name': 'alice'} 这种字面量创建时，键就是原样存进去的，不会触发任何转换逻辑。
- 解决办法：重写
__init__和update，在存入前标准化键名 - 示例：
super().__init__({self._normalize_key(k): v for k, v in kwargs.items()}) - 注意：
_normalize_key必须保证可逆性或唯一性，否则不同原始键可能映射到同一规范键，造成覆盖（如"a-b"和"a_b"都转成"ab"）
和 defaultdict 的关键区别：触发时机与返回值约束
defaultdict 是在键不存在时自动构造并存储一个新值；而 __missing__ 只控制“查不到时返回什么”，不修改字典本身。它返回的值不会被自动设进字典，除非你显式调用 self[key] = value。
立即学习“Python免费学习笔记（深入）”；
- 想实现“首次访问即生成并缓存”，得在
__missing__里手动赋值：self[key] = computed_value; return self[key] - 若只返回临时值（如
list()），下次再查仍会再次调用__missing__，不会复用上次结果 -
defaultdict(list)是更轻量的选择，但如果需要基于键内容动态计算默认值（比如根据 key 前缀决定返回空 dict 还是 0），__missing__更灵活
实际用的时候，最容易忽略的是：它只对 [] 查找生效，且子类必须严格继承 dict 而非 collections.abc.MutableMapping。很多自定义映射类图省事用后者，结果 <strong>missing</strong> 死活不触发。
