直接继承 dict 会出问题，因其 C 实现绕过 Python 方法（如 update 不触发重写的 __setitem__）；UserDict 通过封装 self.data 并代理所有操作解决该问题，但需覆盖 __init__、update 等方法才能确保逻辑统一生效。
为什么直接继承 dict 会出问题？
因为 dict 是用 C 实现的内置类型，很多操作（比如 __setitem__、update、__init__）绕过 Python 层的方法直接调用底层逻辑。你重写 __setitem__，但 update() 依然不会触发它——这是最常踩的坑。
collections.UserDict 的设计初衷就是解决这个问题：它内部封装一个 data 字典（存在 self.data 中），所有操作都通过 Python 方法代理，确保你能拦截全部行为。
- 所有增删改查最终都会走
self.data，而你控制的是代理逻辑 -
UserDict自带完整字典接口，包括keys()、items()、get()等，不用手动实现 - 构造时传入的参数（如
UserDict({'a': 1})）会经由self.data.update(...)处理，所以__setitem__不会被调用——这点必须注意
如何让 __setitem__ 对所有写入生效？
关键在于：不仅要重写 __setitem__，还要覆盖 update 和 __init__，否则初始化或批量更新时你的逻辑就失效了。
from collections import UserDict
<p>class LoggingDict(UserDict):
def <strong>init</strong>(self, *args, *<em>kwargs):
super().<strong>init</strong>() # 先空初始化，避免 data 被自动填充
if args or kwargs:
self.update(</em>args, **kwargs) # 走自己的 update</p><pre class="brush:php;toolbar:false;">def __setitem__(self, key, value):
print(f"Setting {key} = {value}")
super().__setitem__(key, value)
def update(self, *args, **kwargs):
# 手动展开，逐个调用 __setitem__
if len(args) > 1:
raise TypeError("update expected at most 1 arguments")
if args:
other = args[0]
if hasattr(other, "items"):
other = other.items()
for key, value in other:
self[key] = value # 触发 __setitem__
for key, value in kwargs.items():
self[key] = value
-
super().__init__()必须显式调用，且不传参，否则父类会直接调用self.data.update(...)，跳过你的逻辑 -
update里不能直接调super().update()，得手动遍历并赋值，才能触发__setitem__ - 如果只重写
__setitem__，UserDict({'x': 1})初始化时根本不会打印日志
怎样支持键名自动转换（比如全小写）？
这是常见需求，比如统一处理 HTTP Header 或配置项。重点是：所有读写路径都要统一处理键，否则会出现“存进去是小写，取出来却找不到”的情况。
必须同时覆盖：__setitem__、__getitem__、__delitem__、__contains__、pop、get、setdefault……但别漏掉 keys() 返回的键也要标准化。
- 推荐把键标准化逻辑抽成私有方法（如
_normalize_key(key)），所有方法都调它 -
keys()默认返回self.data.keys()，得重写为return list(self.data.keys())或生成器，确保返回的是标准化后的键 - 注意
in操作符依赖__contains__，不重写就会查原始键名
性能和兼容性要注意什么？
UserDict 是纯 Python 实现，比原生 dict 慢约 2–5 倍（取决于操作类型）。对高频读写场景（如每秒万级操作），这个开销可能明显。
- 如果只需要拦截少数操作（比如只监控
__setitem__），且能接受update不触发，用普通 dict 继承 + monkey patch 更轻量 - 若需完整拦截且逻辑复杂（比如带缓存、持久化、类型校验），
UserDict的可维护性优势远大于性能损失 - 第三方库（如
requests、flask）通常只检查isinstance(obj, dict)，UserDict不满足——需要用collections.abc.MutableMapping替代，或加__class__ = dict（不推荐）
真正麻烦的不是写法，而是漏掉某个方法导致行为不一致；比如忘了重写 popitem()，它仍会返回原始键名。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
