深度合并嵌套字典的关键是明确定义合并策略:同键为dict时递归合并,非dict时按需覆盖或保留;标准库无现成函数,但几行递归+类型判断即可实现简洁、透明、可定制的方案。

Python 中深度合并嵌套字典,关键不是“递归拼接”,而是定义清楚**合并策略**:同键遇到 dict 就递归合并,遇到非 dict(如 str、int、list)就按需覆盖或保留。标准库不提供现成函数,但用几行清晰递归 + 类型判断就能实现“优雅”——不依赖第三方、逻辑透明、可定制。
基础智能合并:dict 递归,其余覆盖
这是最常用场景:下层字典自动融合,基础类型(数字、字符串、None 等)以右边为准(后覆盖前):
def deep_merge(left: dict, right: dict) -> dict:
result = left.copy()
for k, v in right.items():
if k in result and isinstance(result[k], dict) and isinstance(v, dict):
result[k] = deep_merge(result[k], v)
else:
result[k] = v
return result
示例
a = {"a": 1, "b": {"x": 10, "y": 20}}
b = {"b": {"y": 99, "z": 30}, "c": "new"}
print(deep_merge(a, b))
→ {'a': 1, 'b': {'x': 10, 'y': 99, 'z': 30}, 'c': 'new'}
处理 list:追加 or 替换?按需选策略
默认合并常把 list 当普通值直接替换(b 中的 list 完全覆盖 a 中的)。若需“列表合并”,得显式判断并处理:
立即学习“Python免费学习笔记(深入)”;
- 追加模式(常见于配置项、标签列表):
if isinstance(result[k], list) and isinstance(v, list): result[k] = result[k] + v - 去重合并(适合 tags):
result[k] = list(set(result[k] + v)) - 完全替换(保持原语义):不做额外处理,走默认赋值
进阶控制:支持自定义冲突解决逻辑
当需要更精细策略(比如“数值相加”、“取较长字符串”、“保留左侧时间戳”),可传入 conflict_resolver 函数:
def deep_merge(left, right, resolver=None):
result = left.copy()
for k, v in right.items():
if k in result and isinstance(result[k], dict) and isinstance(v, dict):
result[k] = deep_merge(result[k], v, resolver)
elif k in result and resolver:
result[k] = resolver(result[k], v)
else:
result[k] = v
return result
例如:数值键自动相加,其余覆盖
merge_with_sum = lambda a, b: (a + b) if isinstance(a, (int, float)) and isinstance(b, (int, float)) else b
deep_merge({"score": 80, "name": "A"}, {"score": 20, "level": "L2"}, merge_with_sum)
→ {'score': 100, 'name': 'A', 'level': 'L2'}
安全边界:避免循环引用与类型错位
真实嵌套结构可能含循环引用或类型不一致(如 a['x'] 是 dict,b['x'] 是 str),建议增加防护:
- 用
id()缓存已处理对象,检测循环引用(适合复杂对象图) - 在递归前加
isinstance(v, dict)双重检查,防止因数据脏导致AttributeError - 对非 dict 同键值,可加 warning 提示类型冲突(开发期调试用)
不复杂但容易忽略:深度合并的本质是定义“同键不同值时谁赢”。写清楚策略,再配简洁递归,比堆砌工具库更可控、更易 debug。










