YAML格式化器：在线格式化、验证和美化YAML

YAML 1.2（2009年）解决了最臭名昭著的YAML陷阱：在YAML 1.1中，未加引号的"yes"、"no"、"on"、"off"、"true"和"false"被解释为布尔值。国家代码如"NO"（挪威）和"YES"变成布尔值false和true——这个bug如此常见以至于被称为"挪威问题"。YAML 1.2仅将"true"和"false"（不区分大小写）识别为布尔值。我们的格式化器检测模糊值并建议为其添加引号。

YAML缩进的黄金法则：每个嵌套级别使用2个空格，绝不使用制表符。YAML 1.2明确禁止使用制表符进行缩进（制表符没有缩进值——它们在解析器的列计数器中显示为0）。如果您从将空格转换为制表符的来源（某些聊天应用程序、Web表单或PDF）复制YAML，验证器将标记每个制表符及其精确位置。

YAML锚点（&）和别名（*）让您定义一次值并在同一文档中多次引用它。例如：`defaults: &defaults timeout: 30 retries: 3`定义了一个锚点，`service_a: <<: *defaults`将这些默认值合并到service_a中。这在Docker Compose中被广泛用于在服务之间共享公共配置，在Kubernetes中用于减少大型清单中的重复。

YAML中的多行字符串有两种风格：字面量块标量（|），保留换行符——用于shell脚本、SQL查询或任何换行符重要的内容；折叠块标量（>），将换行符折叠为空格（类似HTML）——用于长段落、描述或应重排的文本。使用|-（去除尾随换行符）或|+（保留尾随换行符，包括额外的换行符）覆盖默认的尾随换行符行为。

YAML对注释（# 注释）的支持是它相比JSON在配置文件方面最大的优势。注释让您记录为什么选择某个值、链接到Jira工单、标记TODO和解释非显而易见的设置——所有这些都不会破坏解析器。JSON和JSON5的变通方法（如"__comment": "explanation"）是技巧；在YAML中，注释是一等公民。

YAML合并键（<<）是一种特殊的映射键，将一个映射的键合并到另一个映射中。它是YAML 1.1规范的一部分并被广泛支持，虽然不在YAML 1.2核心中。Docker Compose大量使用合并键与锚点来定义服务模板。然而，合并键在嵌套映射方面有已知的边缘情况——要明确深合并与浅合并的预期。

在CI/CD中在部署前验证YAML文件。一个在本地测试通过但在CI中放错位置的YAML会浪费开发者时间。在流水线中添加YAML lint步骤：`yamllint .`或`python -c "import yaml; yaml.safe_load(open('config.yaml'))"`。我们的在线验证器现在与GitHub Actions集成——在您的仓库中添加一个徽章，显示YAML配置的验证状态。

在调试以神秘的"error converting YAML to JSON"启动失败的Kubernetes pod时，问题几乎总是清单中的YAML格式错误。我们的格式化器捕获缩进错误、重复键（在YAML中最后一个值静默胜出——这是设置被神秘忽略的常见原因）以及在错误嵌套级别放置的字段。格式化您的清单，然后使用kubectl重新应用。