YAML通过锚点合并对象及覆写嵌套属性的方法与Python解决方案

核心问题：YAML 原生的<<合并键仅支持浅合并，遇到嵌套对象时会直接替换整个对象，无法实现局部覆写。以下是两种可行的解决方案：

方案1：原生YAML多层锚点实现（无需修改代码） #

给每个嵌套层级单独添加锚点，在覆写时逐层使用<<合并，完全符合YAML 1.2规范，所有支持锚点的YAML解析器都可以正常解析：

profiles:
  home: &home
    key1: value1
    object1: &home_obj1 # 给子对象也加锚点
      subKey1: subVal1
      subKey2: subVal2
      complexObject: &home_complex # 深层嵌套对象也加锚点
        something: value
        someOtherThing: value
  
  work: 
    <<: *home
    object1:
      <<: *home_obj1 # 先合并父层级的object1内容
      subKey2: completelyDifferentValue
      complexObject:
        <<: *home_complex # 合并父层级的complexObject内容
        something: notValue

优点：无需额外代码适配，兼容性好
缺点：嵌套层级较多时，需要手动声明多层锚点，配置文件冗余度较高

方案2：PyYAML自定义深层合并加载器（推荐，适配灵活） #

通过自定义YAML加载器实现自动深层合并，同时支持点式路径直接覆写深层属性，无需修改原配置的写法：

实现代码 #

import yaml
from copy import deepcopy

def deep_merge(base: dict, override: dict) -> dict:
    """递归合并两个字典，覆写字典的优先级更高"""
    result = deepcopy(base)
    for k, v in override.items():
        # 嵌套字典递归合并
        if isinstance(v, dict) and k in result and isinstance(result[k], dict):
            result[k] = deep_merge(result[k], v)
        # 支持点式路径覆写，如 complexObject.something
        elif "." in k:
            parent_key, sub_key = k.split(".", 1)
            result[parent_key] = result.get(parent_key, {})
            deep_merge(result[parent_key], {sub_key: v})
        # 普通键直接覆写
        else:
            result[k] = deepcopy(v)
    return result

class DeepMergeLoader(yaml.SafeLoader):
    """支持深层合并的自定义YAML加载器"""
    def construct_mapping(self, node, deep=True):
        # 先获取原始映射
        mapping = super().construct_mapping(node, deep=deep)
        # 提取合并键内容
        merge_values = {}
        overrides = {}
        for key, val in mapping.items():
            if key == "<<":
                merge_values = deep_merge(merge_values, val)
            else:
                overrides[key] = val
        # 合并基础值和覆写值
        return deep_merge(merge_values, overrides)

使用示例 #

# 你原来的YAML配置不需要做任何修改
yaml_content = """
profiles:
  home: &home
    key1: value1
    object1:
      subKey1: subVal1
      subKey2: subVal2
      complexObject:
        something: value
        someOtherThing: value
  
  work: 
    <<: *home
    object1:
      subKey2: completelyDifferentValue
      complexObject.something: notValue
"""

config = yaml.load(yaml_content, Loader=DeepMergeLoader)
# 输出的config完全符合你预期的结构
print(config["profiles"]["work"]["object1"]["subKey1"]) # 输出：subVal1
print(config["profiles"]["work"]["object1"]["complexObject"]["something"]) # 输出：notValue

优点：无需修改YAML配置写法，适配灵活，支持点式路径直接修改深层属性
缺点：需要Python环境依赖PyYAML，仅适配Python项目

内容的提问来源于stack exchange，提问作者Harsh