本文将深入探讨在python中高效合并两个或多个可能包含嵌套结构的字典的方法。针对键不完全重叠且需保留所有数据的场景，文章将详细介绍如何利用`setdefault()`和`update()`组合实现深度合并，确保数据完整性，并兼顾大型字典的性能需求，提供清晰的代码示例和原理分析。

理解字典合并的挑战

在Python中，合并字典是一个常见的操作。然而，当字典包含嵌套结构，并且两个待合并字典的键不完全重叠时，简单的合并方法（如{**dict1, **dict2}）可能无法满足需求。特别是当顶层键相同但其对应的值是另一个字典时，我们通常希望对这些嵌套字典进行“深度合并”，而不是简单地用第二个字典的值覆盖第一个字典的值。同时，对于大型字典，操作的效率也是一个重要的考量因素。

考虑以下两个示例字典，它们代表了用户数据和用户偏好设置：

dict1 = {'user1': {'name': 'Alice', 'email': 'alice@example.com'},
         'user2': {'name': 'Bob', 'email': 'bob@example.com'}}

dict2 = {'user1': {'preference': 'dark mode', 'timezone': 'EST'},
         'user3': {'preference': 'light mode', 'timezone': 'PST'}}

我们的目标是得到一个合并后的字典，其中：

• user1下的信息应是dict1和dict2中user1信息的组合。
• user2下的信息应完整保留自dict1。
• user3下的信息应完整保留自dict2。

期望结果如下：

立即学习“Python免费学习笔记（深入）”；

merged_dict = {'user1': {'name': 'Alice', 'email': 'alice@example.com', 'preference': 'dark mode', 'timezone': 'EST'},
               'user2': {'name': 'Bob', 'email': 'bob@example.com'},
               'user3': {'preference': 'light mode', 'timezone': 'PST'}}

核心合并策略：利用 setdefault() 和 update()

Python提供了一种非常“Pythonic”且高效的方法来处理这种深度合并场景，即结合使用字典的setdefault()方法和update()方法。这种方法不仅代码简洁，而且在处理大型字典时表现出良好的性能。

工作原理

1. setdefault(key, default_value): 这个方法尝试获取字典中key对应的值。如果key不存在，它会将key插入字典，并将其值设置为default_value，然后返回default_value。如果key已经存在，它则返回key当前的值，而不会修改它。
2. update(other_dict): 这个方法用于将另一个字典（other_dict）的键值对添加到当前字典中。如果键已存在，其值将被other_dict中的值覆盖；如果键不存在，则添加新的键值对。

将这两个方法结合起来，可以实现优雅的深度合并逻辑：对于每个待合并字典中的顶层键k，我们首先确保最终合并字典merged_dict中存在k，并且其值是一个空字典（如果k是第一次出现）。然后，我们将k对应的值（一个嵌套字典）更新到merged_dict[k]中。

macOS UI 自动化技能包 —— 用 Python 控制你的 Mac

让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限

下载

代码示例

dict1 = {'user1': {'name': 'Alice', 'email': 'alice@example.com'},
         'user2': {'name': 'Bob', 'email': 'bob@example.com'}}

dict2 = {'user1': {'preference': 'dark mode', 'timezone': 'EST'},
         'user3': {'preference': 'light mode', 'timezone': 'PST'}}

# 将所有待合并的字典放入一个列表中，便于迭代
dicts_to_merge = [dict1, dict2]
merged_dict = {}

for d in dicts_to_merge:
    for k, v in d.items():
        # 使用setdefault确保merged_dict[k]是一个字典。
        # 如果k不存在，则创建并返回一个空字典；
        # 如果k已存在，则返回其当前值（预期也是一个字典）。
        # 随后，将v的内容更新到这个（空或已存在的）字典中。
        merged_dict.setdefault(k, {}).update(v)

print(merged_dict)

输出结果：

{'user1': {'name': 'Alice', 'email': 'alice@example.com', 'preference': 'dark mode', 'timezone': 'EST'},
 'user2': {'name': 'Bob', 'email': 'bob@example.com'},
 'user3': {'preference': 'light mode', 'timezone': 'PST'}}

这个结果与我们预期的完全一致。

详细解析

让我们逐步分析merged_dict.setdefault(k, {}).update(v)这行代码在处理上述示例时的执行过程：

1. 处理 dict1:

   • 当处理 k='user1', v={'name': 'Alice', 'email': 'alice@example.com'} 时：
     • merged_dict.setdefault('user1', {})：'user1' 不在 merged_dict 中，因此 merged_dict['user1'] 被初始化为 {}，并返回这个 {}。
     • 返回的 {} 调用 update({'name': 'Alice', 'email': 'alice@example.com'})：将 v 的内容添加到 merged_dict['user1'] 中。此时 merged_dict 变为 {'user1': {'name': 'Alice', 'email': 'alice@example.com'}}。
   • 当处理 k='user2', v={'name': 'Bob', 'email': 'bob@example.com'} 时：
     • merged_dict.setdefault('user2', {})：'user2' 不在 merged_dict 中，merged_dict['user2'] 被初始化为 {}，并返回这个 {}。
     • 返回的 {} 调用 update({'name': 'Bob', 'email': 'bob@example.com'})：将 v 的内容添加到 merged_dict['user2'] 中。此时 merged_dict 变为 {'user1': {...}, 'user2': {'name': 'Bob', 'email': 'bob@example.com'}}。

2. 处理 dict2:

   • 当处理 k='user1', v={'preference': 'dark mode', 'timezone': 'EST'} 时：
     • merged_dict.setdefault('user1', {})：'user1' 已经在 merged_dict 中，其值为 {'name': 'Alice', 'email': 'alice@example.com'}。setdefault 返回这个现有值，不会修改它。
     • 返回的 {'name': 'Alice', 'email': 'alice@example.com'} 调用 update({'preference': 'dark mode', 'timezone': 'EST'})：将 v 的内容添加到 merged_dict['user1'] 中。由于 name 和 email 不在 v 中，它们被保留；preference 和 timezone 被添加。此时 merged_dict['user1'] 变为 {'name': 'Alice', 'email': 'alice@example.com', 'preference': 'dark mode', 'timezone': 'EST'}。
   • 当处理 k='user3', v={'preference': 'light mode', 'timezone': 'PST'} 时：
     • merged_dict.setdefault('user3', {})：'user3' 不在 merged_dict 中，merged_dict['user3'] 被初始化为 {}，并返回这个 {}。
     • 返回的 {} 调用 update({'preference': 'light mode', 'timezone': 'PST'})：将 v 的内容添加到 merged_dict['user3'] 中。此时 merged_dict 变为最终结果。

效率考量

这种方法在Python中被认为是高效的，主要有以下几个原因：

• 内置操作优化: setdefault() 和 update() 都是字典的内置方法，它们在C语言层面实现，因此执行速度非常快。
• 避免冗余检查: setdefault() 内部处理了键的存在性检查和默认值设置，避免了显式的if key in dict:判断，简化了逻辑并提高了效率。
• 内存管理: 这种方法通过直接修改目标字典的子字典来构建结果，避免了创建过多的中间字典对象。

总结与注意事项

• 适用场景: 这种方法非常适用于合并多个字典，特别是当它们包含一层嵌套字典，且需要对嵌套层进行深度合并时。
• 非深度递归合并: 需要注意的是，此方法只适用于“一层”深度合并。如果嵌套字典的层级更深（例如dict['user1']['address']['street']），则需要实现一个递归合并函数来处理任意深度的合并。
• 键冲突解决: 如果在嵌套字典的同一层级出现键冲突（例如dict1['user1']['name']和dict2['user1']['name']），update()方法会使用后一个字典的值覆盖前一个字典的值。在上述示例中，user1下的name和email仅存在于dict1，preference和timezone仅存在于dict2，因此没有冲突。如果存在冲突，需要根据具体业务逻辑决定如何处理。

通过掌握setdefault()和update()的组合使用，开发者可以高效且优雅地解决Python中常见的嵌套字典合并问题，从而编写出更健壮、更易维护的代码。