关于此工具
YAML(YAML Ain't Markup Language)与 JSON 是现代云原生与软件工程中最主流的两种数据序列化标准。YAML 依靠缩进和冒号排版,极其适合人类阅读,已成为 Kubernetes(K8s)、Docker Compose、GitHub Actions、Ansible 等配置的事实标准;而 JSON 结构严谨闭合,更适合机器解析与网络传输。本工具提供纯前端 YAML 与 JSON 双向互转,支持语法错误实时行号提示、锚点引用展开与格式美化。
如何使用本工具(操作步骤)
输入 YAML 或 JSON 文本
在左侧编辑窗口粘贴 K8s 资源清单、CI 流程图或普通 JSON 配置,系统自动识别当前代码格式。
执行双向智能转换
点击「YAML 转 JSON」或「JSON 转 YAML」,系统利用严谨的解析器进行语法树遍历与格式重构。
查验语法校验并一键复制
若存在缩进或格式语法错误会高亮标出具体行列;验证通过后一键复制转换后的代码直接使用。
支持复杂 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 间的转换对照
version: '3.8'
services:
web:
image: nginx:alpine
ports:
- "80:80"
restart: always{
"version": "3.8",
"services": {
"web": {
"image": "nginx:alpine",
"ports": [
"80:80"
],
"restart": "always"
}
}
}* YAML 的无括号、无逗号设计更适合人工书写;JSON 的明确闭合更适合程序消费。
JavaScript 常用 YAML 解析与序列化范式
import yaml from 'js-yaml';
// YAML 转 JSON 对象
const obj = yaml.load("name: Alice\nage: 30");
console.log(JSON.stringify(obj, null, 2));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` 模式,杜绝一切远程执行隐患。