ruamel.yaml添加错误缩进标识：如何禁用该自动功能？

我们用Python 3.10搭配ruamel.yaml 0.17.21验证Helm生成的Kubernetes YAML清单时遇到个问题：有一份配置的原始输出是开头带换行符，后面跟着空对象{}。当我们设置了yaml.indent()配置后，输出的YAML里会出现|4标识，导致整个YAML文档无效。目前临时办法是不设置缩进，但其他代码逻辑又依赖这个缩进配置，所以得找个既能保留缩进设置，又能阻止ruamel.yaml加|4这类块标量标识的办法。

下面几个方法都能解决这个问题，按需选择：

1. 预处理输入内容（最简单） #

Helm生成的开头换行属于冗余格式，直接在加载前删掉就行：

import ruamel.yaml

# 读取原始YAML，先移除开头的换行符
with open("helm_output.yaml", "r") as f:
    raw_content = f.read().lstrip('\n')

# 正常设置缩进，加载并转储数据
yaml = ruamel.yaml.YAML()
yaml.indent(mapping=2, sequence=4, offset=2)  # 按自身业务需求配置缩进
data = yaml.load(raw_content)
yaml.dump(data, open("fixed_output.yaml", "w"))

这种方式从源头消除触发块标量的条件，完全不影响其他缩进相关的逻辑。

2. 转换特殊结构为普通标量 #

如果无法修改原始输入内容，就遍历数据结构，把可能被识别成块标量的内容转成普通标量格式：

import ruamel.yaml
from ruamel.yaml.scalarstring import PlainScalarString

yaml = ruamel.yaml.YAML()
yaml.indent(mapping=2, sequence=4, offset=2)

# 加载原始数据
with open("helm_output.yaml", "r") as f:
    data = yaml.load(f)

# 递归检查并修正特殊结构
def fix_block_scalar(data):
    if isinstance(data, str):
        # 匹配开头带换行+空对象的字符串，转换为普通标量
        if data.startswith('\n') and data.strip() == '{}':
            return PlainScalarString('{}')
    elif isinstance(data, list):
        for i in range(len(data)):
            data[i] = fix_block_scalar(data[i])
    elif isinstance(data, dict):
        for k, v in data.items():
            data[k] = fix_block_scalar(v)
    return data

data = fix_block_scalar(data)
yaml.dump(data, open("fixed_output.yaml", "w"))

这样处理后，ruamel.yaml就不会把目标结构当成块标量输出了。

3. 调整ruamel.yaml的序列化参数 #

直接修改yaml对象的默认标量样式，强制禁用自动块标量生成：

import ruamel.yaml

yaml = ruamel.yaml.YAML()
yaml.indent(mapping=2, sequence=4, offset=2)
yaml.default_style = None  # 强制使用普通标量格式
yaml.preserve_quotes = True  # 保留原有引号格式（如果业务需要）

with open("helm_output.yaml", "r") as f:
    data = yaml.load(f)

yaml.dump(data, open("fixed_output.yaml", "w"))

default_style设为None会让ruamel.yaml自动选择最合适的标量格式，但对这种开头换行的空对象，一般不会生成|4这类块标识。

ruamel.yaml看到开头带换行的字符串时，会默认认为这是需要保留换行格式的块内容，所以自动加上|4这类块标量标识。但Helm生成的这个结构其实是格式冗余，根本不是需要保留的块内容，所以通过上面的方法调整后，就能正常输出符合要求的YAML了。

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