# 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 选项一致。

在这里投放广告？

[给我们发邮件](mailto:hi@dennn.is?subject=%E5%9C%A8%20OneClick%20Pro%20%E4%B8%8A%E6%8A%95%E6%94%BE%E5%B9%BF%E5%91%8A)

[广告 适用于 WordPress 的智能体就绪型插件套件。](https://sleekwp.com/?ref=oneclickpro)