这个工具做什么
JSON 适合接口传输,YAML 更适合人工维护的配置文件:没有成对的括号,注释和换行更自然,层级靠缩进表达。同一个数据结构在两种格式里的信息量相同,但读起来的负担差别很大。这个工具把一段合法的 JSON 直接转换成等价的 YAML,适合把接口返回整理成 Ansible、Kubernetes、CI 流水线或应用配置的初稿。
转换过程分两步:先用浏览器内置的 JSON 解析器严格校验并生成数据对象,再用本页自带的序列化逻辑逐层写出 YAML。也就是说,输入必须是标准 JSON——键必须用双引号、不能有注释、不能有尾随逗号。JSON 支持的类型只有对象、数组、字符串、数字、布尔与 null,输出的 YAML 也只覆盖这几种,不会生成锚点、标签、多文档或注释。
所有计算都在当前标签页的内存里完成,输入不会上传,也不会写入本地存储。页面上方显示输入字符数,右侧实时给出 YAML 与行数统计,方便判断输出规模。
怎么用
把 JSON 粘贴到左侧输入框,右侧会在停止输入约 200 毫秒后自动转换,不需要点按钮。输入框会随内容变长而扩展,也可以手动拖动右下角调整高度。改动下方任一选项都会立刻重新生成结果,不必重新粘贴。
- 「缩进空格」控制每一层缩进用 2 个还是 4 个空格。YAML 不允许用制表符缩进,所以这里只提供空格。
- 「字符串引号」选「自动判断」时,只要字符串里出现冒号、井号、方括号等容易被 YAML 误读的符号就加双引号;选「尽量不加引号」时,只在语法必须加引号的情况下才加,输出更干净,但需要确认下游解析器能接受。
- 「按键名排序」对每一层对象的键按字符顺序排列,数组顺序不变。对比两份配置的差异时,固定键序能减少无关的移动。
- 「输出文档头 ---」默认开启,在结果第一行加三个短横线。单个 YAML 文档可以省略,但加上之后更容易和其它文档拼接。
- 「载入示例」填入一段含中文、嵌套对象、数组与换行字符串的 JSON;「复制结果」写入剪贴板;「清空」只清输入与结果,选项保持不变。
输入允许开头带 BOM 或多余空白,工具会先跳过这些字符再解析,因此从 Windows 记事本或某些导出工具拿到的文件可以直接粘贴。除此之外的语法要求与标准 JSON 一致,出错时状态栏会给出第几行第几列,并在下方标出该行的位置。
结果怎么解读
结构与缩进
对象的每个键占一行,形式是「键: 值」;嵌套对象在键的下一行继续缩进,嵌套数组的每一项以短横线加空格开头。数组元素如果是对象,第一个键会跟在短横线后面,其余键与它对齐,例如 - name: web-01 下一行的 ip 会缩进到与 name 同一列。这种写法比「短横线单独一行再缩进」更紧凑,也是大多数 YAML 工具的默认输出。
空对象输出为 {},空数组输出为 [],两者都写在键的同一行,不额外换行。顶层如果是单个值,结果就只有一行,例如输入 null 会得到 null。右侧统计里的「嵌套深度」按最外层算第 1 层,可以据此判断结构复杂度。
引号与块标量
YAML 的裸字符串能表达很多内容,但一批写法会被解析成别的类型:123 是数字,true 是布尔,null 和 ~ 是空值,2026-11-08 在旧版规则里会被当成日期。字符串只要命中这些形态,工具就会加双引号,保证解析回来仍是字符串。空串、首尾带空格、包含「冒号加空格」或「空格加井号」、以 - ? : 等指示符开头的字符串同样必须加引号,否则会改变结构。
包含换行的字符串改用竖线块标量输出,内容按行缩进。字符串本身以换行结尾时用 |,不以换行结尾时用 |-,这样解析回来不会多出一个结尾换行。含回车、制表符或其它控制字符的字符串无法安全放进块标量,会退回双引号写法并用转义表示。键名如果包含空格、标点或看起来像数字,也会加双引号。
常见的几种情况
转换后大整数末位变了
JSON 的数字在 JavaScript 里统一按双精度浮点数存储,能精确表示的最大整数是 9,007,199,254,740,991。超过这个范围的整数,例如订单号 9007199254740993,解析后可能变成 9007199254740992,再输出时就已经不是原值。这不是转换逻辑写错,而是解析阶段就丢了精度。状态栏检测到这类数字时会明确提示个数;需要保留原样时,应让对端系统把长整数写成字符串,或在 JSON 里加引号。
字符串被加上了引号
常见原因是内容里出现了「冒号加空格」或「空格加井号」,这两组组合在 YAML 里有语法含义;也可能是整段内容看起来像数字、布尔或日期。把引号策略切到「尽量不加引号」能减少一部分引号,但真正必须加的地方仍会保留,否则解析结果会变。若下游是严格的 YAML 1.1 解析器,建议保持自动模式。
键名里有中文或点号
中文键名和形如 app.kubernetes.io/name 的键在 YAML 里是合法的裸键,工具默认不加引号。若键里出现空格、冒号、井号,或者整段看起来像数字,就会自动加引号。带斜杠的键不需要特殊处理,但如果下游把它当作路径表达式使用,引号与否可能影响取值,需要按目标工具的文档确认。
提示嵌套过深
工具把嵌套深度限制在 200 层。超过时会直接报错并保留上一次的结果,不会输出半截 YAML,也不会因为递归过深让页面卡死。正常配置很少超过十几层;如果确实遇到很深的树,应先确认数据结构是否合理,或在本地脚本里分段处理,而不是继续加大限制。
使用限制与提醒
单次输入上限为 1,000,000 字符,嵌套深度上限 200 层。超过任一限制时工具不会截断后照常转换,而是提示具体原因并保留上一次的结果。字符数按 JavaScript 的字符串长度计算,一个中文字符算 1,emoji 等需要两个编码单元算 2,与文件字节数不是一回事。
输出是数据层面的等价转换,不保留 JSON 里的书写顺序之外的任何信息——JSON 本身也没有注释、锚点、标签这些概念,所以生成的 YAML 不会有它们。如果目标配置需要注释、多文档分隔或锚点复用,需要在生成后手工补充。键顺序在未开启排序时按解析后的对象顺序输出,整数形式的键可能被引擎提前排到前面,这是 JavaScript 对象本身的规则。
还需要注意 YAML 版本差异。本工具按常见的 YAML 1.2 习惯决定何时加引号,而一些老系统仍使用 1.1 规则,会把 yes、no、on、off 当成布尔值。工具已把这些写法当作需要加引号的情况,但其它自定义标签或类型无法预判。把结果用于生产配置前,应当用目标环境的解析器做一次加载验证。