Python types.MappingProxyType 怎样创建只读映射视图

如果一个模块要把配置字典交给外部调用方，直接返回原始 dict 会让调用方随时改写内部状态；先复制一份又会失去后续配置更新。types.MappingProxyType 解决的是这两个需求之间的缝隙：它提供只读访问，但仍然是原映射的动态视图。

官方文档：https://docs.python.org/3/library/types.html#types.MappingProxyType

本文只讨论映射视图的创建、变化可见性和不可变边界，不把它当成并发同步工具，也不把嵌套对象自动变成深度只读结构。

MappingProxyType 解决的是“能读但不能直接改”

dict.copy() 得到的是一个新的浅副本，之后原字典怎么改都不会自动同步到副本；MappingProxyType 则包装已有映射，调用方读取到的是同一份映射内容的只读视图。

用 types.MappingProxyType 创建只读映射

创建方式很直接：先保留模块内部的原字典，再把它包装后返回。包装对象支持常见的下标读取、get、keys、items、values 和长度查询。

from types import MappingProxyType


def build_public_config():
    # 原字典留在模块内部，维护者仍可按业务规则更新它。
    config = {
        "timeout": 3,
        "retries": 2,
    }
    # 只暴露读取能力，避免调用方直接执行 config["timeout"] = ...。
    return config, MappingProxyType(config)


config, public_config = build_public_config()
print(public_config["timeout"])
print(public_config.get("retries", 0))

这里返回原字典只是为了演示内部更新；真实模块通常只把 public_config 暴露为属性或函数结果。关键点是：MappingProxyType 不负责复制数据，而是限制通过代理对象进行写入。

底层字典变化会同步反映到视图

“只读”容易被误解成“冻结”。实际行为是代理不能写，但持有原字典的内部代码仍然可以写，因此视图会看到这些变化。

from types import MappingProxyType

settings = {"mode": "safe", "limit": 10}
readonly_settings = MappingProxyType(settings)

# 通过原字典更新，代理只负责反映最新内容。
settings["limit"] = 20
settings["region"] = "cn"

print(readonly_settings["limit"])  # 20
print(readonly_settings["region"])  # cn

try:
    # 通过代理写入会被拒绝，调用方只能读。
    readonly_settings["limit"] = 30
except TypeError:
    print("readonly mapping")

因此它适合“单一写入入口、多个读取方”的配置模型：内部集中改变状态，外部可以及时看到新键和值，但不能绕过模块提供的修改规则。

写入异常、浅复制和嵌套对象要分开看

代理拦截的是映射本身的写操作。调用方不能新增键、删除键或替换键值，但读取到的值如果本身是列表、集合或另一个可变字典，并不会自动变成深度只读对象。

from types import MappingProxyType

state = {"tags": ["python"], "limits": {"retry": 2}}
view = MappingProxyType(state)

try:
    # 映射层写入会失败。
    view["new_key"] = "blocked"
except TypeError:
    print("mapping assignment is blocked")

# 嵌套列表仍是原对象；需要业务层决定是否返回副本或不可变类型。
view["tags"].append("stdlib")
print(view["tags"])

# copy() 是浅复制，复制后的顶层映射可以独立增删键。
snapshot = view.copy()
snapshot["snapshot"] = True

如果目标是对外提供完全不可变的数据结构，需要同时设计嵌套值的类型，例如把列表转换为元组，或在边界处做深拷贝；仅套一层 MappingProxyType 不足以完成这个保证。

什么时候该用 MappingProxyType

当模块内部必须保留修改权，而外部只需要读取最新配置时，可以用它做公开属性、只读状态快照入口或类级别的元数据视图。它的成本和语义都比较清晰：不复制顶层数据，读取时看到原映射，写入会抛出 TypeError。

如果调用方需要在某个时刻保存一份独立结果，就使用 dict(view) 或 view.copy()；如果需要线程安全、跨进程一致性或深度不可变，则还要单独设计锁、消息传递、序列化或不可变值类型。不要把只读代理误当成这些机制的替代品。

常见问题

MappingProxyType 是不是深拷贝？

不是。它是对映射的只读动态视图，不复制顶层内容；copy() 也只是浅复制，嵌套对象仍可能共享。

为什么原字典改了，代理里的值也变了？

这是动态视图的设计行为。代理禁止的是通过代理写入，并不阻止拥有原映射的内部代码更新数据。

记住三个判断就够了：想要独立快照用浅复制，想要外部只读且跟随内部更新用 MappingProxyType，想要并发或深度不可变则需要额外的工程机制。