Python加载YAML文件时变量未自动替换的原因及相关疑问

标准YAML不支持原生变量插值 #

你用的yaml.Loader是PyYAML的标准加载器，标准YAML本身就没提供${变量名}这种格式的变量替换能力，所以加载后${vars.path.model}只会被当作普通字符串存着，不会自动替换成vars.path.model对应的值。

目标项目的变量替换是额外实现的 #

你提到的那个GitHub项目并非依赖YAML原生功能，而是：

• 项目自己写了自定义的YAML加载逻辑，扩展了解析规则，专门处理这种变量引用语法
• 或者用了支持变量插值的第三方工具/库，在加载YAML后额外做了变量替换处理
• 简单说，他们的YAML能生效，是因为在加载环节加了自定义处理，不是YAML本身就会干这事

实现变量替换的可行方法 #

如果想让你的配置也实现变量替换，有几种路子：

• 自己写替换逻辑：加载YAML后遍历配置内容，识别${...}格式的字符串，从vars里提取对应值替换
• 用支持变量插值的第三方库，比如pyyaml-include、结合pydantic处理配置
• 手动替换的示例代码：

import yaml
from yaml import Loader

def replace_config_vars(config):
    # 处理字典类型
    if isinstance(config, dict):
        for key, value in config.items():
            if isinstance(value, str) and value.startswith("${") and value.endswith("}"):
                # 解析变量路径，比如vars.path.model拆成['vars','path','model']
                var_parts = value[2:-1].split(".")
                target_value = config
                # 逐层获取变量值
                for part in var_parts:
                    target_value = target_value[part]
                config[key] = target_value
            elif isinstance(value, (dict, list)):
                # 递归处理嵌套结构
                replace_config_vars(value)
    # 处理列表类型
    elif isinstance(config, list):
        for idx, item in enumerate(config):
            if isinstance(item, str) and item.startswith("${") and item.endswith("}"):
                var_parts = item[2:-1].split(".")
                target_value = config
                for part in var_parts:
                    target_value = target_value[part]
                config[idx] = target_value
            elif isinstance(item, (dict, list)):
                replace_config_vars(item)
    return config

# 加载配置并替换变量
config = yaml.load(open("this.yml"), Loader=Loader)
config = replace_config_vars(config)
print(config['test'])  # 输出: ./data/model/sandbox

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