深度合并字典需避免update()或|操作符,可选自定义递归函数、ChainMap模拟只读合并、deepmerge第三方库或copy.deepcopy+递归update组合四种方法。

如果您需要将两个结构不完全相同的字典合并,且希望嵌套字典也能递归合并而非简单覆盖,则需避免使用内置的 update() 或 | 操作符。以下是实现深度合并的多种方法:
一、使用自定义递归函数
该方法通过显式判断键值类型,对嵌套字典进行递归合并,对非字典类型则以右侧字典值为准,确保结构穿透性与可控性。
1、定义函数 deep_merge(dict1, dict2),接收两个字典参数。
2、遍历 dict2 的所有键值对。
立即学习“Python免费学习笔记(深入)”;
3、若当前键在 dict1 中存在且对应值均为字典,则递归调用 deep_merge(dict1[key], dict2[key])。
4、否则,直接将 dict2[key] 赋值给 dict1[key]。
5、返回修改后的 dict1(原地合并)或返回新字典(非破坏性版本需先深拷贝)。
二、利用 collections.ChainMap 模拟只读合并
该方法不真正合并字典,而是创建一个逻辑视图,按查找顺序优先返回右侧字典中键的值;适用于无需物理融合、仅需统一访问接口的场景。
1、导入模块:from collections import ChainMap。
2、构造 ChainMap(dict2, dict1),其中 dict2 在前表示高优先级。
3、访问键时,ChainMap 自动沿链查找首个匹配项,但嵌套字典内部不会被递归合并。
4、如需转为真实字典,须配合递归逻辑单独处理各层嵌套,此时仅作为辅助结构。
三、借助第三方库 deepmerge
该库提供策略化合并能力,支持类型感知(如列表追加、字典递归、标量覆盖等),可精确控制冲突键的行为。
1、安装库:pip install deepmerge。
2、导入策略类:from deepmerge import always_merger。
3、执行合并:result = always_merger.merge(dict1, dict2),自动递归处理嵌套字典。
4、如需自定义规则(例如列表合并为去重并集),可替换为 MergeStrategy 子类实例。
四、使用 copy.deepcopy 与 update 组合(浅层嵌套适用)
该方法适用于已知嵌套层级有限且无循环引用的场景,通过深拷贝避免污染源字典,再逐层更新。
1、导入模块:import copy。
2、创建副本:result = copy.deepcopy(dict1)。
3、定义辅助函数 update_nested(target, source),遍历 source 键值。
4、若键存在且 target[key] 与 source[key] 均为 dict,则递归调用自身;否则赋值 target[key] = source[key]。
5、调用 update_nested(result, dict2) 完成合并。










