如何在 Python 中安全合并字典并智能归并重复键的值-Python教程-PHP中文网

如何在 Python 中安全合并字典并智能归并重复键的值

本文介绍一种健壮、通用的字典合并方法：当键冲突时，自动将值归并为列表（无论原值是单个元素还是已有列表），确保不丢失任何数据，且兼容嵌套或混合类型场景。

本文介绍一种健壮、通用的字典合并方法：当键冲突时，自动将值归并为列表（无论原值是单个元素还是已有列表），确保不丢失任何数据，且兼容嵌套或混合类型场景。

在 Python 中合并字典时，若仅用 update() 或解包（如 {**d1, **d2}）会覆盖重复键的值，导致数据丢失；而简单地将冲突值转为 [old, new] 又无法处理一方已是列表的情况（例如 {'a': [1]} 与 {'a': 3} 合并应得 {'a': [1, 3]}，而非 [[1], 3]）。为此，我们需要一个类型感知的合并策略：对每个键的所有值统一“扁平化”为列表项。

推荐使用 collections.defaultdict(list) 实现高效、可读性强的合并逻辑：

from collections import defaultdict

def merge_dicts(dict1, dict2):
    """
    安全合并两个字典：相同键的值被收集到列表中。
    若原值为列表，则将其元素逐个添加；否则直接追加该值。
    """
    merged = defaultdict(list)

    for d in (dict1, dict2):
        for key, value in d.items():
            if isinstance(value, list):
                merged[key].extend(value)  # 展开列表，避免嵌套
            else:
                merged[key].append(value)  # 单值直接加入

    return dict(merged)

# 示例 1：基础合并
dict1 = {'a': 1, 'b': 2, 'c': 3}
dict2 = {'b': 3, 'c': 4, 'd': 5}
print(merge_dicts(dict1, dict2))
# 输出: {'a': [1], 'b': [2, 3], 'c': [3, 4], 'd': [5]}

# 示例 2：混合类型（含已有列表）
dict1 = {'a': [1], 'b': 2}
dict2 = {'a': 3, 'b': [4], 'c': 5}
print(merge_dicts(dict1, dict2))
# 输出: {'a': [1, 3], 'b': [2, 4], 'c': [5]}

✅ 优势说明：

A Python CLI skill for Cutout.Pro visual APIs — background removal, face cutout, and photo enhancement. Supports file upload & image URL input.

调用 Cutout.Pro 视觉处理 API 进行背景移除、人像抠图和照片增强，支持文件上传与图片 URL 输入。

下载

✅ 无嵌套风险：extend() 处理已有列表，append() 处理标量，结果始终是“一维列表”；
✅ 扩展性强：可轻松支持多字典合并（只需修改 for d in (dict1, dict2, ...)）；
✅ 类型安全：isinstance(value, list) 显式判断，避免误判元组、集合等其他序列类型（如需支持更多容器，可扩展为 collections.abc.Sequence）；
✅ 零副作用：不修改原始字典，返回全新字典。

⚠️ 注意事项：