python 3.9+ 的 | 操作符是最简洁的字典合并方式,返回新字典、不修改原对象,但仅支持两两浅合并,不处理嵌套、要求键可哈希且全为 dict 类型。

用 | 合并多个字典最直接,但只支持 Python 3.9+
Python 3.9 引入的 | 是目前最简洁、语义最清晰的合并方式,适合快速组合配置、参数或临时数据。它返回新字典,不修改原对象,行为确定:右操作数键值对完全覆盖左操作数同名键。
常见错误是误以为 | 支持链式多操作——其实只能两两合并,d1 | d2 | d3 合法,但底层是 (d1 | d2) | d3,性能略低于一次性解包;更关键的是,它不处理嵌套结构,{"x": {"y": 1}} | {"x": {"z": 2}} 结果是 {"x": {"z": 2}},旧嵌套被整个替换。
- 必须全是
dict类型,dict | list或dict | None直接报TypeError - 键必须可哈希,含列表、集合等不可哈希类型作键会立即失败,不是合并逻辑问题,而是字典构造本身不合法
- 若需合并 5 个以上字典,写
d1 | d2 | d3 | d4 | d5不如用解包语法,可读性和维护性都更好
update() 看似快,但就地修改容易埋雷
update() 的底层是 CPython 哈希表原地插入,确实比构造新字典省内存、少分配,但代价是破坏原始数据。很多人在配置合并场景中写 defaults.update(user_config),结果后续其他模块读 defaults 时拿到已被污染的值。
真正安全的用法是显式复制再更新:
final = base.copy() final.update(ext1) final.update(ext2)
这看似多两行,但避免了隐式副作用。另外,update() 接收任意映射或键值对可迭代对象(比如 [(k, v)]),传错格式可能静默出错——例如传入 [("a", 1), ("b")](长度不一致)会触发 ValueError,但不会立刻暴露。
-
update()不做键存在性检查,重复调用同一键会反复覆盖,无警告 - 无法处理嵌套合并,
{"db": {"host": "a"}}.update({"db": {"port": 5432}})结果仍是{"db": {"port": 5432}} - Python 3.9+ 支持
|=,语义等价于update(),但更易识别意图
ChainMap 根本不是合并,别当真用
ChainMap 只是逻辑上“查一层”,不生成新字典,也不拷贝数据。它把多个字典按顺序组成查找链,读取时从第一个开始找,找到就返回,不继续往后搜。一旦某个源字典被修改,ChainMap 的行为立刻变化——这不是 bug,是设计如此。
典型误用是把它当合并结果传给需要真实 dict 的函数(比如 json.dumps() 或 requests.post(json=...)),这时会报 TypeError: Object of type ChainMap is not JSON serializable。
- 适合只读场景:比如环境变量 + 配置文件 + 命令行参数的优先级叠加
- 不能用于需要键遍历(
for k in cm:)或长度统计(len(cm))的逻辑,因为行为不符合直觉 - 没有
.copy()方法,想固化当前视图得手动dict(cm),此时才真正合并——但已失去ChainMap的轻量优势
需要深度合并或自定义冲突策略?别硬凑内置方法
所有内置合并方式(|、**、update())都是浅层覆盖,对嵌套字典、列表值、数字累加等需求完全无能为力。比如两个字典都含 "tags": ["a"],你想要 ["a", "a"] 而不是覆盖,就必须跳出语法糖。
简单定制可用字典推导式或循环,但注意性能损耗;生产环境建议用 deepmerge 或手写递归函数。例如处理重复键时取最大值:
def merge_max(d1, d2):
merged = {**d1, **d2}
for k in d1.keys() & d2.keys():
merged[k] = max(d1[k], d2[k])
return merged
这种逻辑无法靠 update() 或 | 表达,硬套只会让代码越来越难懂。
- 嵌套层级越深,自定义逻辑越必要;盲目依赖
ChainMap或多次update()只会让问题延迟暴露 - 第三方库如
deepmerge提供策略配置(覆盖/递归/列表追加),但引入依赖前先确认是否真需要——多数配置合并其实只需一层 - 最容易被忽略的是键类型兼容性:
{**d1, **d2}要求所有键是字符串或可哈希对象,而ChainMap对键类型无限制,这点常被忽略
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!











