JSON 转 YAML

JSON to YAML Converter

输入
输出
 

使用说明

JSON 与 YAML 表达的是同一类数据:映射、序列与标量。差异在于语法密度 —— YAML 用缩进代替括号与引号,因此同样的内容写出来更短、更像自然语言。 这也是配置文件普遍改用 YAML 的原因:Kubernetes 清单、Docker Compose、 GitHub Actions 工作流都是 YAML。

转换中真正需要小心的是类型保真。字符串 "true" 与布尔值 true 在 YAML 里如果都不加引号,就会被解析成同一个东西; 字符串 "8080" 与数字 8080 同理。 本工具会判断标量的真实类型,对可能产生歧义的字符串加上引号, 避免转成 YAML 后再转回来时类型已经变了。

多行字符串怎么处理

JSON 里带换行的字符串会输出为 YAML 的块标量,用 |- 引导, 保留内部换行但不保留结尾换行。这样生成的配置文件在被人工阅读时仍然是多行形态, 而不是一整行带 \n 的转义串。

YAML 的几个反直觉规则

第一,YAML 禁止用 Tab 缩进,用了会直接解析失败,这是从其他格式迁移过来时最常见的报错。 第二,yes、no、on、off 在 YAML 1.1 里会被当成布尔值, 写成这些值的字符串需要加引号。第三,以 - 开头的字符串如果不加引号, 会被当作序列项而不是值。

反向转换的局限

YAML 转 JSON 时会处理锚点引用(&anchor / *anchor)的展开与块标量, 但自定义类型标签(如 !Ref)不做语义展开,会保留为普通字符串。 另外 YAML 的注释在转成 JSON 时会丢失,因为 JSON 没有注释语法。

常见问题

转换后原来的注释会保留吗?
不会。JSON 标准本身不支持注释,源数据里不存在注释信息;YAML 转 JSON 时同样会因为目标格式的限制而丢弃注释。需要保留说明请改用 YAML 文件本身维护。
JSON 里的 null、布尔值会怎么处理?
会按 YAML 原生的 null、true、false 输出,不会被当成字符串。数字也保持数值类型,不加引号。这一层类型保真是手写转换最容易出错的地方。
YAML 缩进用几个空格合适?
YAML 规范禁止使用 Tab 缩进。社区惯例是 2 个空格,Kubernetes 官方示例也用 2 空格,建议与项目现有文件保持一致。
支持 YAML 转 JSON 吗?
支持,切换方向即可。解析 YAML 时会处理锚点引用与多行字符串块,但自定义类型标签(如 !Ref)不会做语义展开。

相关工具

最后更新:2026-11-20