# YAML 转 JSON 在线工具 - YAML 与 JSON 互转、多文档、报错定位

> 免费在线 YAML 与 JSON 互转：支持多文档、锚点引用与合并键，语法错误精确到行列，可设缩进、键排序与折行，适合 compose、Kubernetes 配置。

- 网址: https://qilingtools.com/zh/yaml-json
- 分类: 开发工具 (https://qilingtools.com/zh/dev)
- 标签: [格式转换](https://qilingtools.com/zh/tags/convert), [开发](https://qilingtools.com/zh/tags/dev), [数据格式](https://qilingtools.com/zh/tags/data)
- 最后更新: 2026-10-26
- 价格: 免费，无需注册
- 隐私: 在浏览器本地处理，文件不上传服务器

Kubernetes 清单、docker-compose、GitHub Actions、Spring Boot 配置都用 YAML，而程序和接口更常用 JSON。把 YAML 粘进来即可得到格式化的 JSON，反过来也能把 JSON 转成干净的 YAML。解析基于成熟的 yaml 库，完整支持 YAML 1.2：多文档用 --- 分隔（可合并成 JSON 数组或输出为 JSON Lines）、锚点 & 与引用 *、<< 合并键、块状字符串 | 和 >、各种引号写法。语法错误会指出具体的行和列并附上出错行，重复的键也会报出来。JSON 转 YAML 时可以选择缩进、按键名排序、字符串统一加双引号、长字符串按 80 列折行，还能把顶层数组拆成多个 YAML 文档。一键“结果作为输入”可以反向转换，方便核对来回转换是否一致。

## 使用步骤

1. 选择 YAML → JSON 或 JSON → YAML
2. 粘贴内容，按需设置缩进、排序、多文档等选项
3. 复制或下载转换结果，有错误时按提示的行列修改

## 功能特点

- YAML 与 JSON 双向转换
- 多文档 --- 合并为数组或 JSON Lines
- 支持锚点、引用与 << 合并键
- 语法错误与重复键精确到行列
- 缩进、键排序、字符串引号、长文本折行可选
- 顶层数组可拆成多个 YAML 文档
- 一键反向转换，本地处理不上传

## 常见问题

### YAML 里的锚点和 << 合并键会怎么处理？

锚点 &name 定义的内容会在引用 *name 的地方完整展开；勾选“支持 << 合并键”后，docker-compose 等常见的 <<: *common 写法会把公共配置合并进当前对象，本对象里写的键优先。转换后的 JSON 里不再有锚点，所有值都是展开后的结果。

### 一个文件里有多个 YAML 文档怎么办？

用 --- 分隔的多个文档会被逐个解析。默认合并成一个 JSON 数组，每个元素是一个文档；也可以选择每个文档输出一行（JSON Lines），方便逐条处理 Kubernetes 清单等。

### 为什么 yes、on、日期没有变成布尔值或日期？

工具按 YAML 1.2 核心规范解析：只有 true / false 是布尔值，yes、no、on、off 是普通字符串；日期也保留为字符串，因为 JSON 没有日期类型。这与 Kubernetes 等现代工具的行为一致，也避免了 NO 被当成 false 的经典问题。

### 数据会上传到服务器吗？

不会。转换完全在浏览器本地进行，配置文件里的密码、密钥等敏感信息不会离开你的电脑，关闭页面即清除。

## 相关工具

- [JSON 格式化](https://qilingtools.com/zh/json): 免费在线 JSON 格式化：一键美化、压缩，实时语法校验并定位到出错行列，支持树形视图折叠、键名排序、转义与去转义、Unicode 转中文、复制下载，数据不上传。
- [Base64 编解码](https://qilingtools.com/zh/base64): 免费在线 Base64 编码解码工具：支持中文 UTF-8、URL 安全变体，文本与 Base64 互转，实时转换，本地处理不上传。
- [URL 编解码](https://qilingtools.com/zh/url-encode): 免费在线 URL 编码解码工具：encodeURIComponent 与 encodeURI 两种模式，处理中文、空格与特殊符号，本地实时转换不上传。
- [JWT 解析](https://qilingtools.com/zh/jwt): 免费在线 JWT 解析工具：解码 JWT 的 Header 与 Payload，展示过期时间、签发时间等，本地解析不上传，保护令牌安全。
- [时间戳转换](https://qilingtools.com/zh/timestamp): 免费在线 Unix 时间戳转换工具：时间戳与日期互转，自动识别秒/毫秒，显示本地时间、UTC、ISO 8601 和相对时间，实时更新。
- [哈希计算](https://qilingtools.com/zh/hash): 免费在线哈希/摘要计算工具：对文本或文件计算 SHA-1、SHA-256、SHA-384、SHA-512，使用浏览器加密接口本地完成，文件不上传。
- [UUID 生成](https://qilingtools.com/zh/uuid): 免费在线 UUID 生成器：使用加密安全随机数批量生成符合 RFC 4122 的 UUID v4，可大写、去连字符、加花括号，一键复制。
- [进制转换](https://qilingtools.com/zh/base-convert): 免费在线进制转换工具：二进制、八进制、十进制、十六进制及任意 2–36 进制互转，支持大整数（BigInt），本地实时计算。