T工具箱
≔

YAML 转 JSON

YAML 与 JSON 双向转换

关于此工具

YAML(YAML Ain't Markup Language)与 JSON 是现代云原生与软件工程中最主流的两种数据序列化标准。YAML 依靠缩进和冒号排版,极其适合人类阅读,已成为 Kubernetes(K8s)、Docker Compose、GitHub Actions、Ansible 等配置的事实标准;而 JSON 结构严谨闭合,更适合机器解析与网络传输。本工具提供纯前端 YAML 与 JSON 双向互转,支持语法错误实时行号提示、锚点引用展开与格式美化。

如何使用本工具(操作步骤)

1

输入 YAML 或 JSON 文本

在左侧编辑窗口粘贴 K8s 资源清单、CI 流程图或普通 JSON 配置,系统自动识别当前代码格式。

2

执行双向智能转换

点击「YAML 转 JSON」或「JSON 转 YAML」,系统利用严谨的解析器进行语法树遍历与格式重构。

3

查验语法校验并一键复制

若存在缩进或格式语法错误会高亮标出具体行列;验证通过后一键复制转换后的代码直接使用。

支持复杂 YAML 锚点与别名引用

完整支持 YAML 的 `&anchor` 锚点定义与 `*alias` 别名复用特性,在转为 JSON 时自动展平展开对应对象属性。

精准定位缩进与语法报错行号

针对 YAML 对空格缩进极其严苛的特点,遇到 Tab 混用或缩进不对齐时实时指出出错行号,排查配置文件零痛苦。

纯本地离线转换,集群配置绝不外泄

所有转换均在浏览器本地线程中执行,生产服务器部署清单、微服务拓扑与环境变量绝无泄露风险。

YAML 语法严苛规则与经典避坑要点

  • •严禁混用制表符(Tab):YAML 规范中**严格禁止使用 Tab 键**进行缩进,必须全部使用纯空格(通常为 2 个或 4 个空格)。在很多代码编辑器中敲入 Tab 会直接导致语法解析器报错崩溃。
  • •挪威国家代码引发的“Norway Problem”布尔陷阱:在 YAML 1.1 规范中,未加引号的 `NO`、`yes`、`on`、`off` 会被自动隐式转换为布尔值 `false` 或 `true`。若将挪威代码写为 `country: NO`,转为 JSON 会离奇变成 `"country": false`!国家代码与纯字符务必加双引号包裹!
  • •冒号与破折号后必须紧跟空格:YAML 键值对中的冒号(`key: value`)以及列表项的短横线(`- item`)后面**必须留有至少一个空格**。漏掉空格(如 `key:value`)会被整句视作普通字符串。

代码与转换对比示例

典型 Docker Compose 配置在 YAML 与 JSON 间的转换对照

YAML 配置原文
version: '3.8'
services:
  web:
    image: nginx:alpine
    ports:
      - "80:80"
    restart: always
转换输出的 JSON 结构
{
  "version": "3.8",
  "services": {
    "web": {
      "image": "nginx:alpine",
      "ports": [
        "80:80"
      ],
      "restart": "always"
    }
  }
}

* YAML 的无括号、无逗号设计更适合人工书写;JSON 的明确闭合更适合程序消费。

JavaScript 常用 YAML 解析与序列化范式

使用 js-yaml 库
import yaml from 'js-yaml';

// YAML 转 JSON 对象
const obj = yaml.load("name: Alice\nage: 30");
console.log(JSON.stringify(obj, null, 2));
JSON 对象转 YAML
const data = { app: "toolbox", port: 3000 };
// 输出整洁缩进的 YAML 文本
const yamlStr = yaml.dump(data, { indent: 2 });
console.log(yamlStr);

* `yaml.load()` 会自动推断类型(布尔值、整数、浮点数与字符串)。

常见问题解答

Q: JSON 可以直接被当作有效的 YAML 来解析吗?

A: 完全可以。YAML 规范(从 YAML 1.2 起)正式定义了“JSON 是 YAML 的官方子集(Strict Superset)”。任何合法的 JSON 文本,在 YAML 解析器眼中都是完全合法的 YAML 数据。

Q: 如何安全处理 YAML 中的多行大文本段落?

A: 使用管道符 `|`(保持字面量原样换行,保留末尾回车)或折叠符 `>`(将换行折叠为单空格,适合长段落文本)。例如:`description: | Line 1 Line 2`。

Q: YAML 解析器存在安全执行漏洞吗?

A: 在部分后端语言(如 Python PyYAML 或 Ruby)中,不安全的 `yaml.load()` 函数支持反序列化任意语言对象甚至执行系统指令。本工具纯前端采用严格无代码执行风险的 `safeLoad` 模式,杜绝一切远程执行隐患。

相关推荐工具

所有处理都在你的浏览器本地完成,数据不会上传到服务器。
/