Python 3.12+ 已移除 collections.Mapping,只读字典需继承 dict 并重写全部9个可变方法(如 __setitem__、update、clear 等)统一抛 TypeError;嵌套只读需递归包装 dict 值;通过 object.__setattr__(self, '_data', data) 避免初始化写入,确保“动不了”而非仅“看起来像”。

为什么直接用 collections.Mapping 不再适用
Python 3.12+ 已彻底移除 collections.Mapping 抽象基类,继承它会触发 AttributeError: module 'collections' has no attribute 'Mapping'。即便在旧版本中,仅继承该类也不提供实际只读保障——它不拦截 __setitem__ 或 clear() 等修改操作,只是声明“我看起来像字典”。真正细粒度控制必须手动覆盖所有可变接口。
如何拦截所有写入路径(包括 update、pop、setdefault)
只重写 __setitem__ 和 __delitem__ 远不够。用户仍可通过 dict.update()、dict.pop()、dict.setdefault()、dict.clear() 等方法间接修改底层数据。必须显式覆盖全部 9 个可变方法:
__setitem____delitem__clearpoppopitemsetdefaultupdate-
__ior__(|=原地合并) -
__reversed__虽然不写入,但某些工具会调用它试探行为,建议抛出TypeError明确拒绝
每个方法都应统一抛出 TypeError("readonly dictionary"),避免部分方法静默失败或行为不一致。
如何支持嵌套只读视图(例如 dict['x']['y'] = 1 失败)
若包装的原始字典含嵌套 dict,用户可能通过 d['outer']['inner'] = 42 绕过外层只读限制。解决方式不是深拷贝(性能差、破坏引用语义),而是对所有嵌套字典值也返回只读包装器:
def __getitem__(self, key):
val = self._data[key]
if isinstance(val, dict) and not isinstance(val, ReadOnlyDict):
return ReadOnlyDict(val)
return val
注意:仅对 dict 类型做包装,避免对 list、set 等其他可变类型误判;同时检查是否已是 ReadOnlyDict 实例,防止重复包装。
如何让 isinstance(d, dict) 返回 True 且保持 pickle 兼容
继承 dict 是最直接的方式,能自然通过类型检查、支持 pickle 序列化,并复用所有只读方法(如 keys()、get())的默认实现。但必须小心:dict.__init__ 会尝试写入,所以不能在 __init__ 中直接调用 super().__init__(data) —— 应改用 self.update(data) 并确保此时 update 已被重写为只读。
正确做法是绕过父类初始化,用 object.__setattr__(self, '_data', data) 存储原始数据,再把只读逻辑完全建立在 _data 上,不依赖 dict 的内部状态。这样既避开初始化陷阱,又保留 isinstance(d, dict) 为 False 的明确语义——如果你确实需要伪装成 dict,那必须用 __class__ = dict 黑魔法,但会破坏继承链和调试体验。
细粒度的核心不在“像不像”,而在“动不了”——哪怕用户用 vars(d) 看到 _data,只要所有公开接口都守门,就达到了只读目的。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!











