JY

JSON 转 YAML

JSON → YAML,引号与多行文本都处理好了


                

如何使用本工具

  1. 左边贴 JSON,右边立刻出 YAML,改任何选项都会实时重算。
  2. 字符串里有换行时自动用 | 块标量,比一行 \n 堆着可读得多。
  3. 「字符串固定加引号」默认开启,YAML 更稳但没那么好看;关掉后只给必要的字符串加引号。
  4. 顶层是数组或标量时 YAML 也合法,但大多数配置工具要求顶层是对象,标签会提示。
  5. 复制出去直接粘进 .yaml 文件,注意别让编辑器把行尾空格吃掉。

常见问题

Q:YAML 的缩进到底能不能用 Tab?

A:不能。YAML 规范明确禁止用 Tab 做缩进,只能用空格。混用或误用会报 found character '\t' that cannot start any token,这类错误信息很难懂,实际就是缩进符不对。本工具只输出空格,粘贴时注意编辑器别自动转换。

Q:为什么 YAML 里的字符串要加引号?

A:因为有些裸字符串会被解析成别的类型:yes / no / on / off 在 YAML 1.1 里是布尔值,1.0 是浮点数,null 和 ~ 是空值,含 : 或 # 的会被当成键值分隔或注释。加引号就是告诉解析器「这是字符串」。

Q:多行文本用 | 和 > 有什么区别?

A:| 是字面块,保留所有换行;> 是折叠块,把单个换行折成空格,只有空行才产生换行。写脚本、SQL、配置文件用 |,写长段落散文用 >。本工具统一用 |,因为保留原文最安全。

Q:JSON 里的 null 转成 YAML 是什么?

A:输出 null,YAML 里 null、Null、NULL、~ 和空值都表示 null,效果一样。转回去也一样。注意空字符串要写成 \"\",什么都不写会被当成 null。

Q:键名里有冒号或空格怎么办?

A:必须加引号。a:b 会被解析成键 a 值为 b,\"a:b\": 1 才是键名 a:b。本工具用 needQuote() 判断,冒号、井号、方括号、花括号、& * ! | > 这些 YAML 元字符都会触发加引号。

Q:生成的 YAML 能直接给 K8s 用吗?

A:结构上可以,但要注意 K8s 要求 apiVersion、kind、metadata 三个字段齐全,且缩进必须是空格。本工具的示例就是一个最小 Deployment,粘进去改镜像和名字即可。