JSON 与 YAML 互转

关于此工具

两种格式的关系

JSON 和 YAML 描述的是同一类数据：映射、列表、字符串、数字、布尔值和 null。YAML 1.2 在设计上把 JSON 作为自己的子集，并加入了手工编辑文件所需的功能：注释、用缩进代替括号、多行字符串、一个文件中的多个文档，以及用于复用值的锚点和别名。

从 JSON 转到 YAML 会保留所有的值，只有一个例外：同一个对象中出现两次的键只保留最后一个值，因为 YAML 映射中的键不能重复。从 YAML 转到 JSON 只保留数据：注释会消失，别名和 << 合并键会被替换为它们指向的值，!Ref 这样的自定义标签会被去掉而值保留，不是字符串的键（例如 1 或 true）会变成对应的文本。

值得了解的 YAML 陷阱

挪威问题。在 YAML 1.1 中，不带引号的 yes、no、on 和 off 都是布尔值，所以在一份国家代码列表里，挪威的代码 no 会变成 false。YAML 1.2 只保留了 true 和 false。此工具中的解析器遵循 YAML 1.2，除非文档以 %YAML 1.1 指令开头，所以它把 no 读作字符串“no”。许多仍在使用的解析器采用 1.1 的规则，因此此工具在输出 YAML 时会给这类字符串加上引号。

版本号。不带引号的 1.10 是浮点数，作为数字它就是 1.1。版本号、邮政编码以及其他只是看起来像数字的内容，都必须加引号才能保持为文本：version: "1.10"。

此工具如何转换

你最后编辑的一侧是源，另一侧根据它重写。如果源无法解析，错误会显示在它下方，另一侧保留上一次有效的转换结果。缩进选项作用于生成的一侧；修改 JSON 缩进也会重新缩进你输入的 JSON，而你输入的 YAML 永远不会被重写，因为那样会删掉其中的注释。

键保持源中的顺序，包括由数字组成的键，而 JavaScript 对象会把这类键移到最前面。大于 2 的 53 次方的整数在两个方向上都逐位复制。用 --- 分隔多个文档的 YAML 文件会变成 JSON 数组，页面上会给出提示。在同一个 YAML 映射中使用两次的键会被报告为错误。YAML 的读取和输出由开源的 yaml 包完成，它在你的浏览器中运行。