YAML 格式化程序
使用这款 YAML 格式化程序验证并整理 YAML。粘贴配置、Kubernetes 清单、CI 流水线或 front matter,工具会解析文档以捕获语法错误,然后规范化冒号后、列表短横线后以及流式集合(如 [a, b] 和 { x: 1 })内的空格。缩进、注释、引号和块标量都会保持原样,让 DevOps 工程师和开发者能够安全地获得更整洁的文件。
常见问题
YAML 格式化程序会更改什么?
它会规范化空格:映射冒号后加一个空格,列表短横线后加一个空格,流式序列中的逗号后加一个空格,流式映射的大括号内加空格。注释前的多个空格会缩减为一个。
它会重新缩进我的 YAML 吗?
不会,它会保留你输入的缩进,因为缩进在 YAML 中用于定义结构。缩进四个空格的嵌套块会继续保留四个空格缩进。
它会验证文档吗?
会。工具会先解析文档,并通过错误消息和行号报告错误,例如流式映射中的冒号后未加空格。请修复报告的行,再次进行格式化。
注释会保留吗?
会保留整行注释和行尾注释。值与 # 符号之间会保留一个空格。
块标量会怎样处理?
以 | 或 > 引入的字面块标量和折叠块标量会原样复制,包括各行内的空格。所有比键缩进更深的行都属于该标量,并会保持不变。
带引号的字符串会被更改吗?
不会。单引号和双引号字符串及其内部的空格都会保留。绝不会添加或删除引号,因此值的类型也会保持不变。
行尾格式会改变吗?
是的,Windows CRLF 和旧版 Mac 的 CR 行结束符都会转换为 LF。YAML 解析器对两者的处理相同,因此数据不会改变。
它能格式化一个文件中的多个文档吗?
不能。用 --- 分隔的多个文档会被拒绝,并显示“Multiple documents are not supported”(不支持多个文档)消息。请分别格式化每个文档,然后再将它们合并。
为什么结果会被包在 yaml 代码围栏中?
输出会以标记为 yaml 的 Markdown 代码块形式返回,因此会在 Markdown 中以高亮形式呈现。请将围栏之间的内容复制到你的 .yaml 或 .yml 文件中。
文件大小上限是多少?
每次运行最多支持 5 MB;超过此大小的输入会被拒绝并显示提示。空输入会返回空结果,输出与 Code Formatter 的 YAML 选项一致。