PyYAML FullLoader在ruamel.yaml中的替代方案及差异解析

对应 PyYAML.FullLoader 的替代方案 #

加载可信文件时，不需要使用ruamel.YAML(typ="unsafe")。typ="unsafe"对应PyYAML的UnsafeLoader，会允许加载未注册的自定义标签（存在安全风险，仅适用于完全可信的文件）。

正确的替代方式是直接初始化默认的ruamel.yaml.YAML()实例，它的行为和PyYAML.FullLoader对齐：支持所有标准YAML结构，禁止执行任意代码，同时保留了ruamel.yaml独有的格式保留特性。如果需要明确指定安全加载模式，也可以用ruamel.YAML(typ="safe")，但默认模式已经足够覆盖可信文件的加载需求。

两者加载方式的核心差异 #

• 格式保留：ruamel.yaml加载时会完整保留原文件的注释、缩进、换行等格式，后续dump时可以原样输出；PyYAML.FullLoader加载后会丢失这些元信息，dump结果是重新格式化的内容。
• 标签处理：PyYAML.FullLoader需要手动注册自定义标签才能加载，否则会抛出异常；ruamel.yaml默认拒绝未注册的自定义标签（和FullLoader一致），而typ="unsafe"会跳过标签校验直接加载，风险更高。
• 类型映射：ruamel.yaml对YAML类型的解析更严格贴合规范，比如不会把带前导零的字符串（如"00123"）自动转换为整数；PyYAML在部分场景下会自动做类型转换，可能导致意外的类型变化。
• API设计：ruamel.yaml采用面向对象的API设计，加载后返回的是有序字典（CommentedMap）等特殊类型，方便后续修改和保留格式；PyYAML.FullLoader默认返回普通字典，结构是无序的。

处理YAML中的类Unix环境变量 #

ruamel.yaml和PyYAML都不原生支持解析$PROJ_PATH这类环境变量，需要手动扩展加载逻辑。最直接的实现方式是先读取文件内容，替换环境变量后再加载：

import os
from ruamel.yaml import YAML

def load_yaml_with_env(file_path):
    yaml = YAML()
    with open(file_path, 'r', encoding='utf-8') as f:
        raw_content = f.read()
    # 替换所有$VAR格式的环境变量，不存在的变量会保留原字符串
    processed_content = os.path.expandvars(raw_content)
    return yaml.load(processed_content)

如果需要更精细的控制（比如只替换指定变量、处理不存在的变量），可以自定义字符串替换逻辑，或者通过ruamel.yaml的构造函数钩子实现动态替换。

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