如何用Python生成无转义换行的多行YAML文件？无需逐行存变量

嘿，我来帮你搞定这个YAML换行的困扰！你遇到的问题其实是PyYAML默认的格式处理逻辑导致的——直接带\n的字符串会被转义成单行，而我们完全不用把每行拆成单独变量，只要用对方法就能让库自动输出正确的多行块格式。

下面是两种简单有效的解决办法：

方法1：利用PyYAML自动识别多行文本（推荐） #

首先确保你安装了PyYAML库：

pip install pyyaml

然后直接用三重引号编写你的多行内容，把它放进Python字典结构里，让PyYAML帮你处理格式转换：

import yaml

# 用三重引号直接写多行内容，不用手动加\n
multiline_content = """这是第一行的内容
第二行可以包含任意空格或特殊字符
第三行继续编写
最后一行收尾"""

# 构建YAML对应的Python数据结构
yaml_data = {
    'document_title': '我的多行YAML文档',
    'detailed_content': multiline_content,
    'version': '1.0'
}

# 写入YAML文件，关键参数确保格式正确
with open('output.yaml', 'w', encoding='utf-8') as f:
    yaml.safe_dump(
        yaml_data,
        f,
        allow_unicode=True,  # 支持中文等非ASCII字符
        default_flow_style=False,  # 禁用流式格式，输出标准块级YAML
        sort_keys=False  # 保留你定义的键的顺序，不自动排序
    )

生成的YAML文件会是这样的规范格式：

document_title: 我的多行YAML文档
detailed_content: |
  这是第一行的内容
  第二行可以包含任意空格或特殊字符
  第三行继续编写
  最后一行收尾
version: 1.0

方法2：强制使用Literal块样式（适合严格控制格式的场景） #

如果你想强制指定某个字段必须用块样式输出（不管内容是否有换行），可以用LiteralScalarString来标记内容：

import yaml
from yaml.scalarstring import LiteralScalarString

# 用LiteralScalarString包裹多行内容，强制块格式
multiline_content = LiteralScalarString("""第一行文本
第二行文本
第三行文本""")

yaml_data = {
    'forced_multiline': multiline_content
}

with open('output.yaml', 'w', encoding='utf-8') as f:
    yaml.safe_dump(
        yaml_data,
        f,
        allow_unicode=True,
        default_flow_style=False,
        sort_keys=False
    )

关键要点总结 #

• 别手动拼接带\n的字符串后直接写文件，交给PyYAML处理格式转换更靠谱
• default_flow_style=False是核心参数，它能让输出从单行流式变成标准的块级YAML
• Python的三重引号是编写多行字符串最便捷的方式，完全不需要把每行拆成单独变量

试试上面的方法，你就能得到格式正确、无转义换行的YAML文件啦！

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