如何将 YAML 转换为 JSON 格式

转换前先确认输入类型

YAML 和 JSON 都常用于保存配置与结构化数据，但它们的写法不同。当后续流程需要 JSON 文本时，可以使用这个工具完成格式转换。输入内容会先按 YAML 解析，再生成 JSON 文本，因此对象映射、嵌套映射和序列都能按层级呈现在结果中。工具也接受空白内容；这类输入会得到一个空的 JSON 对象，适合先确认转换流程是否能够正常返回结果。

按设置完成格式转换

在输入区域粘贴或输入需要处理的 YAML 文本，并保留原有的层级关系。
按结果的阅读或后续处理需求调整 JSON 缩进；没有修改时，默认缩进为 2。需要整理对象键的排列时，再启用键排序选项；该选项默认关闭。
执行转换，查看生成的 JSON 文本，并确认顶层结构符合后续用途。
处理多文档内容时，检查开头的文档标记以及后续的分隔行。若文本包含多个需要保留的非空文档，结果会以 JSON 数组呈现；只保留一个非空文档时，结果会直接呈现该文档。
如果结果未成功生成，回到输入内容检查缩进层级、冒号后的内容、列表标记和文档分隔位置，再重新转换。

从输出形态判断转换状态

成功结果是 JSON 文本，而不是原 YAML 的排版副本。映射通常会成为 JSON 对象，序列会成为 JSON 数组，嵌套关系则通过对象或数组的层级表达。多文档处理还会移除解析后为空的文档；如果没有剩下可保留的文档，结果会回到空的 JSON 对象。

格式不正确的 YAML 不会得到成功的 JSON 输出。即使文本能够被解析，若解析后的值不能用 JSON 表示，转换也会报告失败。遇到失败时，应分别核对语法和内容类型，而不要只根据输出区域是否出现文字来判断转换成功。由于工具会重新序列化解析后的数据，原始注释、引号写法和排版布局不属于可依赖的保留内容。

使用示例

你需要把包含名称和项目列表的配置文本交给只接受 JSON 的后续处理流程。

在输入区域粘贴一段包含 name 字段和 items 列表字段的 YAML 文本，保留默认缩进设置并执行转换，然后检查输出的顶层对象与列表字段。

结果形状为一个 JSON 对象，其中包含与输入结构对应的字段，并以 JSON 数组表示列表字段。

使用限制

它的已验证用途是将 YAML 文本转换成 JSON 文本；解析后的值若无法进行 JSON 序列化，操作会失败，且不应将其视为 JSON 转 YAML 工具或期待原注释、引号写法和排版布局保持不变。

常见错误

缩进层级、冒号或列表标记出现语法问题时，转换会失败；请逐行修正这些 YAML 结构后再执行转换。

常见问题

不输入内容也能转换吗？

条件是输入为空或只含空白字符；此时操作仍会成功，输出为一个空的 JSON 对象。

嵌套对象和列表可以转换吗？

可以，已验证的输入结构包括对象映射、嵌套映射和序列，解析后的值会被序列化成 JSON。

多文档 YAML 会输出什么？

当左侧去除空白后的内容以“---”开头，并且后面存在换行加“---”的分隔形式时，工具会按多文档处理；多个非空文档组成数组，单个非空文档则直接作为结果。