### 使用 `ruamel.yaml` 库处理 YAML 文件 在 Python 中，`ruamel.yaml` 是一个功能强大的库，用于读取和写入 YAML 数据。它不仅支持标准的 YAML 语法，还能够保留原始文件中的注释、格式和其他元数据。 以下是关于如何使用 `ruamel.yaml` 处理 YAML 文件的具体方法： #### 安装 `ruamel.yaml` 要安装该库，可以使用 pip 命令： ```bash pip install ruamel.yaml ``` #### 加载 YAML 文件 加载 YAML 文件可以通过以下方式实现： ```python import sys from ruamel.yaml import YAML yaml = YAML() # 打开并读取 YAML 文件 with open('example.yaml', 'r') as file: data = yaml.load(file) print(data) ``` 上述代码展示了如何通过 `ruamel.yaml.YAML().load()` 方法来解析 YAML 文件的内容[^1]。 #### 将字典保存为 YAML 文件 如果需要将 Python 字典转换为 YAML 格式的文件，则可执行如下操作： ```python data_to_save = { 'name': 'John Doe', 'age': 30, 'is_student': False, } with open('output.yaml', 'w') as file: yaml.dump(data_to_save, file) ``` 此部分说明了利用 `dump()` 函数把对象序列化到文件的过程[^2]。 #### 圆程保持（Round-Trip） 当希望修改现有 YAML 文件而不丢失其原有结构或注释时，“圆程模式”非常有用。启用它的做法很简单： ```python yaml.preserve_quotes = True yaml.explicit_start = True yaml.indent(mapping=2, sequence=4, offset=2) with open('existing_file_with_comments.yaml', 'r') as file_in: existing_data = yaml.load(file_in) existing_data['new_key'] = 'value' with open('updated_file.yaml', 'w') as file_out: yaml.dump(existing_data, file_out) ``` 这里强调的是 `ruamel.yaml` 的能力——即使是在更新文档的同时也能维持原有的样式与备注信息[^3]。 #### 注意事项 尽管 `PyYAML` 和其他类似的模块也可以完成基本的任务，但是它们通常不具备像 `ruamel.yaml` 那样的高级特性，比如完全兼容旧版 YAML 版本以及更好地控制输出格式等功能。 ---