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 里的 null、布尔值会怎么处理?
YAML 缩进用几个空格合适?
支持 YAML 转 JSON 吗?
相关工具
最后更新:2026-11-20