本文介绍一种健壮、通用的字典合并方法：当键冲突时，自动将所有值（无论是否已是列表）统一归集为列表，避免数据丢失或类型错误，适用于混合数据类型场景。
本文介绍一种健壮、通用的字典合并方法：当键冲突时，自动将所有值（无论是否已是列表）统一归集为列表，避免数据丢失或类型错误，适用于混合数据类型场景。
在 Python 中合并字典时，若仅用 update() 或解包（如 {**d1, **d2}），会直接覆盖重复键的值，导致数据丢失；而简单判断是否为列表再拼接的方式又容易因类型嵌套不一致而出错。更可靠的做法是：对每个键的所有值进行统一归集处理——无论原始值是标量（如 int、str）还是列表，都展开后追加到结果列表中。
以下是一个专业、可复用的实现方案，使用 collections.defaultdict 提升效率，并兼顾类型安全与语义清晰性：
from collections import defaultdict
def merge_dicts(dict1, dict2):
"""
安全合并两个字典：对重复键的值自动归集为列表。
支持混合类型值（如 int、str、list），自动展平嵌套列表。
Args:
dict1 (dict): 第一个字典
dict2 (dict): 第二个字典
Returns:
dict: 合并后的字典，所有键对应值均为 list（即使原值唯一）
"""
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]}✅ 关键优势说明：
提示词大师-python版
下载
图片提示词生成器？不止如此。 马甲系统 —— 把脑海中的画面，翻译成AI能理解的专业表达。 用得越多，它越懂你：首次需要多问几句确认方向，用久了几乎一说就懂。 用得越多，它越快：缓存机制让后续对话越来越省。 RAG进化：成功案例持续入库，越跑越聪明。 输入「新手指南」查看完整功能介绍
- ✅ 类型自适应：自动识别 list 并 extend，其余类型统一 append，避免 [2] + 3 类型错误；
- ✅ 无损归集：即使某键在任一字典中只出现一次，结果仍为列表（语义一致，便于后续统一处理）；
- ✅ 可扩展性强：可轻松扩展支持 tuple、set 等可迭代类型（只需增加 isinstance 判断）；
- ✅ 线程安全（读场景）：函数式设计，不修改原字典，适合多线程/异步环境。
⚠️ 注意事项：
立即学习“Python免费学习笔记（深入）”；
- 若需保留非列表形式的单一值（如仅当冲突时才转为列表），需额外状态跟踪，逻辑复杂度上升；本方案优先保证一致性与鲁棒性；
- 对于深层嵌套结构（如字典中含字典），此方法仅处理一层，如需递归合并，请考虑专用库（如 deepmerge）；
- Python 3.9+ 可结合 | 操作符做初步合并，但仍需后处理归集逻辑，无法替代本方案。
总结：该方法以 defaultdict(list) 为核心，通过统一展平策略消除类型歧义，是处理“按键归集值”类需求的 Pythonic 实践范例——简洁、健壮、即开即用。
