Python字典合并的5种实现方法详解 | 完整教程与代码示例

为什么需要字典合并？

在Python编程中，字典合并是一个常见需求，尤其是在处理配置信息、API响应数据或合并多个数据源时。Python提供了多种字典合并方法，各有适用场景和特点。

方法1：update()方法

最传统的字典合并方式，直接修改原始字典


# 使用update()方法合并字典
dict1 = {'a': 1, 'b': 2}
dict2 = {'b': 3, 'c': 4}

# 合并dict2到dict1中
dict1.update(dict2)

print(dict1)  # 输出: {'a': 1, 'b': 3, 'c': 4}

特点： 直接修改原字典，不返回新字典；后面的字典键值会覆盖前面的

方法2：字典解包（**）

Python 3.5+ 引入的字典解包操作符，创建新字典


# 使用字典解包合并
dict1 = {'a': 1, 'b': 2}
dict2 = {'b': 3, 'c': 4}
dict3 = {'d': 5}

# 合并多个字典
merged_dict = {**dict1, **dict2, **dict3}

print(merged_dict)  # 输出: {'a': 1, 'b': 3, 'c': 4, 'd': 5}

特点： 创建新字典，不修改原始字典；右侧字典的键值覆盖左侧

方法3：字典推导式

灵活处理键值冲突，可在合并时进行转换


# 使用字典推导式合并
dict1 = {'a': 1, 'b': 2}
dict2 = {'b': 3, 'c': 4}

# 合并并解决键冲突（值相加）
merged_dict = {
    key: dict1.get(key, 0) + dict2.get(key, 0)
    for key in set(dict1) | set(dict2)
}

print(merged_dict)  # 输出: {'a': 1, 'b': 5, 'c': 4}

特点： 最灵活的方法，可自定义合并逻辑；适用于需要复杂合并规则的场景

方法4：ChainMap

来自collections模块，创建字典的逻辑视图


from collections import ChainMap

dict1 = {'a': 1, 'b': 2}
dict2 = {'b': 3, 'c': 4}

# 创建ChainMap对象
chain = ChainMap(dict1, dict2)

# 访问时优先返回dict1中的值
print(chain['b'])  # 输出: 2

# 转换为普通字典
merged_dict = dict(chain)
print(merged_dict)  # 输出: {'a': 1, 'b': 2, 'c': 4}

特点： 不实际合并数据，创建字典的"视图"；原始字典修改会反映在ChainMap中；查找顺序从左到右

方法5：Python 3.9+ 合并运算符

Python 3.9引入的字典合并专用运算符


# Python 3.9+ 合并运算符
dict1 = {'a': 1, 'b': 2}
dict2 = {'b': 3, 'c': 4}

# 使用 | 运算符合并
merged_dict = dict1 | dict2

print(merged_dict)  # 输出: {'a': 1, 'b': 3, 'c': 4}

# 使用 |= 运算符就地合并
dict1 |= dict2
print(dict1)  # 输出: {'a': 1, 'b': 3, 'c': 4}

特点： 最简洁的语法；| 创建新字典，|= 就地合并；Python 3.9及以上版本可用

方法对比与选择指南

方法	是否创建新字典	Python版本	适用场景
update()	否	所有版本	需要就地修改原始字典
字典解包(**)	是	3.5+	需要合并多个字典且创建新字典
字典推导式	是	2.7+	需要自定义合并逻辑
ChainMap	视图对象	2.7+	需要高效访问多个字典而不实际合并
合并运算符(\|)	是	3.9+	简洁语法，优先选择

实际应用场景示例

场景1：合并配置信息


# 合并默认配置和用户自定义配置
default_config = {
    'theme': 'light',
    'font_size': 14,
    'notifications': True
}

user_config = {
    'theme': 'dark',
    'language': 'zh'
}

# 合并配置，用户配置优先
final_config = {**default_config, **user_config}
print(final_config)
# 输出: {'theme': 'dark', 'font_size': 14, 'notifications': True, 'language': 'zh'}

场景2：合并多个API响应


# 合并多个API返回的数据
api_response1 = {'user_id': 123, 'name': 'Alice', 'email': 'alice@example.com'}
api_response2 = {'email': 'alice.new@example.com', 'role': 'admin'}
api_response3 = {'last_login': '2023-06-15', 'status': 'active'}

# 使用ChainMap合并
from collections import ChainMap
user_data = ChainMap(api_response3, api_response2, api_response1)

# 访问用户数据（优先使用最新数据）
print(dict(user_data))
# 输出: {'last_login': '2023-06-15', 'status': 'active', 
#       'role': 'admin', 'email': 'alice.new@example.com',
#       'user_id': 123, 'name': 'Alice'}