将 YAML 转换为 JSON!

输入 YAML,即可转换为 JSON!支持 yml, Kubernetes, docker-compose。
YAML
结果
 

将 YAML 转换为 JSON!

把 YAML(yml)文档转换成 JSON,看清被缩进掩盖的结构,以及每个值实际被解析成了什么类型。锚点和别名会展开成真正的值,用 --- 分隔的多个文档会收集到一个数组中。

它尤其适合找出 YAML 的经典错误:因为少了一个空格,值挂到了错误的父节点下;或者 version: 1.10 悄无声息地变成了数字 1.1。

使用方法

  1. 把 docker-compose.yml、Kubernetes manifest 或 workflow 文件粘贴到 YAML 框中,也可以直接把文件拖进去。
  2. 语法错误会连同行号和列号一起显示在结果中;先检查该位置的缩进。
  3. 阅读 结果 下的 JSON,确认每个值变成了字符串、数字还是布尔值,需要时复制。

示例

输入 (YAML)
name: ci
on:
  push:
    branches: [main]
defaults: &node
  runs-on: ubuntu-latest
  timeout-minutes: 10
jobs:
  test: *node
输出 (JSON)
{
  "name": "ci",
  "on": {
    "push": {
      "branches": [
        "main"
      ]
    }
  },
  "defaults": {
    "runs-on": "ubuntu-latest",
    "timeout-minutes": 10
  },
  "jobs": {
    "test": {
      "runs-on": "ubuntu-latest",
      "timeout-minutes": 10
    }
  }
}

GitHub Actions 的 on: key 仍然是字符串 key "on",因为本工具按 YAML 1.2 规则解析。用 &node 锚点定义的块在 *node 处被展开。

支持的功能

  • 按 YAML 1.2 core schema 解析:yes、on、off 仍是字符串,只有 true/True/false 才是布尔值。
  • ~ 和空值变成 null;十六进制 0x1F 和八进制 0o17 变成数字。
  • &anchors 和 *aliases 会解析为所引用的值。
  • 字面量块 | 和折叠块 > 按 YAML 的换行规则转换成字符串。
  • 多个以 --- 分隔的文档会变成 JSON 数组;单个文档则直接输出其值。
  • 同一个映射中出现两次的 key 会报错。

使用场景

检查 Kubernetes manifest 的缩进

如果 containers 下的 env 少缩进了一级,它会悄悄挂到另一个字段上,直到 apply 时才发现。在 JSON 中,大括号会清楚地表明它属于哪个对象。

在代码中使用配置

对于引入 YAML 解析器显得小题大做的脚本或前端 bundle,把配置转换一次,然后用 import config from './config.json' 使用。

查看 OpenAPI 规范

用 YAML 编写的 OpenAPI 文档转换成 JSON 后,更容易用 JSONPath 或 jq 查询,例如取出某个路径下的 schema。

注意事项与限制

  • 合并 key(<<: *defaults)会被应用:锚点映射中的 key 被复制进来,与 << 写在一起的 key 会覆盖它们。仅支持 YAML 1.2 的解析器会把 << 当作普通 key,因此结果可能与这类工具不同。
  • 2024-01-01 这样的日期时间保持为字符串,不会变成 Date 值。
  • .inf 和 .nan 在 JSON 中无法表示,会变成 null。
  • 注释无法带入 JSON,会被丢弃。
  • PyYAML(YAML 1.1)会把 on 和 yes 读成 true,所以用 Python 得到的结果可能不同。

常见问题

为什么 GitHub Actions 的 on 显示为 "on" 而不是 true?

在 YAML 1.2 中,布尔值只有 true 和 false,所以 on 是普通字符串,GitHub Actions 也是这样读取这个 key 的。Python 的 PyYAML 遵循 1.1,会把它变成 True key,在脚本中解析 workflow 时要小心。

version: 1.10 输出成了 1.1。

不加引号的 1.10 在 YAML 中是数字,而 1.10 等于 1.1。要保留版本字符串,请在源 YAML 中加引号写成 "1.10"。

包含多个文档的文件会怎样?

每个以 --- 分隔的文档按顺序成为数组的一个元素,所以用于 kubectl apply -f 的多资源文件会得到一个资源数组。