ChainMap通过从左到右查找多个映射实现配置优先级覆盖，同名键由左侧映射遮蔽；修改仅作用于首个映射，支持new_child()和parents动态调整层级，适用于命令行>环境变量>用户配置>默认值等场景。
collections.ChainMap 通过按顺序组合多个字典（或映射对象），实现“从左到右查找、优先使用首个匹配”的逻辑，天然适配多层配置的优先级覆盖：越靠前的映射优先级越高，同名键会被左侧映射的值遮蔽（shadow），无需手动合并或深拷贝。
核心机制：只读视图 + 查找链
ChainMap 不真正合并字典，而是维护一个映射列表（maps），每次 get() 或 __getitem__ 都从 maps[0] 开始逐个查找，找到即返回。修改操作（如 update()、pop()）默认只作用于第一个映射（即最顶层），保持底层配置不可变。
- 查找顺序固定：
maps[0] → maps[1] → ... → maps[-1] - 新增键只写入
maps[0]，不影响低优先级配置 - 删除键也只在
maps[0]中进行；若该键不在顶层，则抛出KeyError
典型配置分层结构示例
常见场景如：命令行参数 > 环境变量 > 用户配置文件 > 默认配置。只需按优先级从高到低传入字典：
import collections import osdefaults = {"timeout": 30, "retries": 3, "log_level": "INFO"} user_config = {"timeout": 60, "log_level": "DEBUG"} env_vars = {"log_level": "WARNING"} # 通过 os.environ 模拟 cli_args = {"retries": 1}
config = collections.ChainMap(cli_args, env_vars, user_config, defaults) print(config["timeout"]) # 60（来自 user_config，因 cli_args 无此键） print(config["log_level"]) # "WARNING"（来自 env_vars，遮蔽了 user_config 和 defaults） print(config["retries"]) # 1（来自 cli_args，最高优先级）
动态调整优先级与局部覆盖
ChainMap 支持运行时插入新映射（new_child()）或移除顶层（parents 属性），适合嵌套作用域或临时覆盖：
-
config.new_child({"debug": True})返回新 ChainMap，新字典在最前 -
config.parents返回去掉maps[0]后的 ChainMap（即降级一层） - 可配合
map属性直接访问各层，例如config.maps[2]["timeout"]查看用户配置原始值
注意边界：非递归、不自动类型合并
ChainMap 是扁平映射，不处理嵌套结构或类型差异：
- 若配置含嵌套 dict（如
{"db": {"host": "localhost"}}），它不会自动合并子字段，整个"db"键被整体覆盖 - 无法自动将字符串
"true"转为布尔值，类型转换需业务层自行处理 - 所有映射必须是 dict-like 对象，但不要求是
dict；支持自定义映射类（只要实现__getitem__和keys()）
用 ChainMap 管理多层配置，关键在于把“谁优先”转化为“谁在左边”，避免冗余拷贝，也规避了深合并的复杂性。它不解决配置解析或验证，但为优先级控制提供了轻量、透明、可组合的基础。
