Python YAML模块详解（从入门到实战：PyYAML使用全指南）

什么是PyYAML？

Python本身并不内置YAML支持，但通过第三方库 PyYAML，我们可以轻松地在Python中读写YAML文件。PyYAML是目前最流行的Python YAML处理库，支持YAML 1.1规范。

安装PyYAML

首先，你需要安装PyYAML模块。打开终端或命令提示符，运行以下命令：

pip install pyyaml

基础用法：读取YAML文件

假设我们有一个名为 config.yaml 的配置文件，内容如下：

# config.yamlapp:  name: MyWebApp  version: 1.2.0  debug: truedatabase:  host: localhost  port: 5432  username: admin  password: secret123

现在，我们使用Python来读取这个YAML文件：

import yaml# 打开并读取YAML文件with open('config.yaml', 'r', encoding='utf-8') as file:    config = yaml.safe_load(file)# 打印整个配置print(config)# 访问具体字段print("应用名称:", config['app']['name'])print("数据库端口:", config['database']['port'])

运行结果将输出一个嵌套字典，你可以像操作普通Python字典一样访问其中的数据。这里使用了 yaml.safe_load() 而不是 yaml.load()，因为前者更安全，能防止恶意代码执行。

写入YAML文件

你也可以将Python字典写入YAML文件：

import yaml# 准备数据data = {    'project': {        'name': 'DataPipeline',        'version': '2.0.1',        'dependencies': ['numpy', 'pandas', 'pyyaml']    }}# 写入YAML文件with open('output.yaml', 'w', encoding='utf-8') as file:    yaml.dump(data, file, allow_unicode=True, default_flow_style=False)

参数说明：

• allow_unicode=True：允许写入Unicode字符（如中文）。
• default_flow_style=False：生成块状风格（block style）的YAML，更易读。

常见问题与注意事项

1. 安全性：永远不要对不可信的YAML文件使用 yaml.load()，它可能执行任意Python代码。请始终使用 yaml.safe_load()。
2. 编码问题：在打开文件时指定 encoding='utf-8' 可避免中文乱码。
3. 数据类型：YAML会自动将数字、布尔值等转换为对应的Python类型（如 true → True）。

总结

通过本教程，你已经掌握了Python yaml模块的基本用法，包括如何安装PyYAML、读取和写入YAML文件。无论是做自动化运维、配置管理还是数据交换，YAML解析都是Python开发者必备技能之一。希望这篇PyYAML教程能帮助你快速上手，并在实际项目中灵活运用Python读取YAML的能力。

小贴士：YAML对缩进非常敏感，请确保使用空格而非Tab进行缩进！