在Python开发中，嵌套字典的合并是处理复杂数据结构时的常见需求，比如整合多份配置文件、合并不同来源的接口返回数据等场景，普通的字典合并操作无法正确处理深层嵌套的键值对，需要更针对性的方法来实现。
普通字典合并方法的局限性
Python内置的字典合并方式主要有两种，一种是使用update方法，另一种是使用解包语法，这两种方式都只能处理一层字典的合并，遇到嵌套字典时会出现深层键值被直接覆盖的问题。
先看普通合并的示例：
# 定义两个嵌套字典
dict1 = {"a": 1, "b": {"x": 10, "y": 20}}
dict2 = {"b": {"y": 30, "z": 40}, "c": 3}
# 使用update方法合并
merged_update = dict1.copy()
merged_update.update(dict2)
print(merged_update) # 输出: {'a': 1, 'b': {'y': 30, 'z': 40}, 'c': 3}
# 使用解包语法合并
merged_unpack = {**dict1, **dict2}
print(merged_unpack) # 输出: {'a': 1, 'b': {'y': 30, 'z': 40}, 'c': 3}
可以看到，dict2中的<b>键对应的嵌套字典直接替换了dict1中的<b>对应的嵌套字典，原本的<x>键值对丢失，这显然不符合嵌套字典合并的预期。
递归合并嵌套字典的实现
要实现深层嵌套字典的合并，核心思路是递归遍历字典的键值对，当遇到值也是字典的情况时，继续递归合并，否则直接更新键值。下面是自定义的递归合并函数实现：
def merge_nested_dict(base_dict, update_dict):
"""
递归合并两个嵌套字典
:param base_dict: 基础字典，合并结果会修改这个字典
:param update_dict: 待合并的字典
:return: 合并后的字典
"""
for key, value in update_dict.items():
# 如果当前键在基础字典中，且两个值都是字典，递归合并
if key in base_dict and isinstance(base_dict[key], dict) and isinstance(value, dict):
merge_nested_dict(base_dict[key], value)
else:
# 否则直接更新键值
base_dict[key] = value
return base_dict
# 测试递归合并函数
dict1 = {"a": 1, "b": {"x": 10, "y": 20}}
dict2 = {"b": {"y": 30, "z": 40}, "c": 3}
result = merge_nested_dict(dict1.copy(), dict2)
print(result) # 输出: {'a': 1, 'b': {'x': 10, 'y': 30, 'z': 40}, 'c': 3}
这个递归函数可以正确处理多层嵌套的字典合并，相同键的深层键值会被更新，不存在的键会被新增，不会丢失原有的深层结构。
使用第三方库快速合并
如果不想自己实现递归逻辑，也可以使用成熟的第三方库来完成嵌套字典的合并，常用的有dict_merge和deepmerge库。
使用deepmerge库
首先需要安装deepmerge库：
pip install deepmerge
然后使用库提供的合并方法：
from deepmerge import always_merger
dict1 = {"a": 1, "b": {"x": 10, "y": 20}}
dict2 = {"b": {"y": 30, "z": 40}, "c": 3}
result = always_merger.merge(dict1, dict2)
print(result) # 输出: {'a': 1, 'b': {'x': 10, 'y': 30, 'z': 40}, 'c': 3}
deepmerge库还支持自定义合并策略，比如可以设置列表是追加还是替换，满足更复杂的合并需求。
不同合并方法的对比
下面是几种常见嵌套字典合并方法的对比：
| 方法 | 优点 | 缺点 | 适用场景 |
|---|---|---|---|
| 自定义递归函数 | 无额外依赖，逻辑可控 | 需要自己维护代码，复杂场景需要扩展 | 简单嵌套场景，不想引入第三方依赖 |
| deepmerge库 | 功能完善，支持自定义策略，开箱即用 | 需要安装第三方库 | 复杂嵌套场景，需要灵活合并策略 |
| 普通update/解包 | 内置方法，速度快 | 无法处理深层嵌套 | 仅合并一层字典的场景 |
注意事项
- 递归合并时要注意避免循环引用的问题，比如两个字典互相嵌套引用，会导致递归无限循环。
- 如果字典中的值包含列表、元组等其他可迭代对象，需要根据需求扩展合并逻辑，默认递归函数只处理字典类型的值。
- 合并前如果需要保留原字典，记得先调用copy方法复制原字典，避免修改原数据。
嵌套字典合并的核心是根据值的类型判断是否需要继续递归，选择适合自己场景的方法可以大幅提升开发效率，避免重复造轮子。