把 YAML(yml)文档转换成 JSON,看清被缩进掩盖的结构,以及每个值实际被解析成了什么类型。锚点和别名会展开成真正的值,用 --- 分隔的多个文档会收集到一个数组中。
它尤其适合找出 YAML 的经典错误:因为少了一个空格,值挂到了错误的父节点下;或者 version: 1.10 悄无声息地变成了数字 1.1。
YAML 框中,也可以直接把文件拖进去。结果 下的 JSON,确认每个值变成了字符串、数字还是布尔值,需要时复制。name: ci
on:
push:
branches: [main]
defaults: &node
runs-on: ubuntu-latest
timeout-minutes: 10
jobs:
test: *node
{
"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 处被展开。
yes、on、off 仍是字符串,只有 true/True/false 才是布尔值。~ 和空值变成 null;十六进制 0x1F 和八进制 0o17 变成数字。&anchors 和 *aliases 会解析为所引用的值。| 和折叠块 > 按 YAML 的换行规则转换成字符串。--- 分隔的文档会变成 JSON 数组;单个文档则直接输出其值。如果 containers 下的 env 少缩进了一级,它会悄悄挂到另一个字段上,直到 apply 时才发现。在 JSON 中,大括号会清楚地表明它属于哪个对象。
对于引入 YAML 解析器显得小题大做的脚本或前端 bundle,把配置转换一次,然后用 import config from './config.json' 使用。
用 YAML 编写的 OpenAPI 文档转换成 JSON 后,更容易用 JSONPath 或 jq 查询,例如取出某个路径下的 schema。
<<: *defaults)会被应用:锚点映射中的 key 被复制进来,与 << 写在一起的 key 会覆盖它们。仅支持 YAML 1.2 的解析器会把 << 当作普通 key,因此结果可能与这类工具不同。2024-01-01 这样的日期时间保持为字符串,不会变成 Date 值。.inf 和 .nan 在 JSON 中无法表示,会变成 null。on 和 yes 读成 true,所以用 Python 得到的结果可能不同。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 的多资源文件会得到一个资源数组。