JSON转YAML转换器

欢迎使用 JSON转YAML转换器，这是一个专为开发人员、DevOps 工程师和系统管理员设计的强大在线工具。即时将您的 JSON 数据转换为整洁、可读的 YAML 格式 —— 非常适合配置文件、Kubernetes 清单、Docker Compose 文件和 CI/CD 流水线。

为什么要将 JSON 转换为 YAML？

虽然 JSON 和 YAML 都可以表示相同的数据结构，但 YAML 在配置文件方面具有多项优势：

• 提高可读性： YAML 使用缩进而不是大括号和中括号，使复杂的嵌套结构更容易阅读和一眼看懂。
• 注释支持： YAML 允许使用（#）添加注释，而 JSON 不支持。这对于记录配置选项非常有价值。
• 减少视觉干扰： 键名不需要引号，项之间不需要逗号，YAML 文件更简洁且易于维护。
• 行业标准： Kubernetes、Ansible、Docker Compose、GitHub Actions 和 GitLab CI 等主流 DevOps 工具都将 YAML 作为其主要配置格式。

常见使用场景

如何使用此转换器

1. 输入您的 JSON： 将您的 JSON 数据粘贴到输入区域，或使用“上传文件”按钮加载 .json 文件。您也可以尝试点击示例模板来查看转换器的实际效果。
2. 选择选项： 选择您喜欢的缩进大小（2 或 4 个空格）。（可选）启用紧凑数组的流式风格，或添加文档开始标记 (---)。
3. 转换： 点击“转换为 YAML”来转换您的数据。转换器会验证您的 JSON 语法，并显示带有行号的错误提示。
4. 使用输出结果： 一键复制 YAML 到剪贴板，或将其下载为 .yaml 文件。统计信息会显示您数据的结构。

了解选项设置

缩进大小

YAML 使用空格来表示结构。选择 2 个空格（默认，更紧凑）或 4 个空格（对深度嵌套的数据更具可读性）。两者都是有效的 YAML；根据您团队的偏好或工具要求进行选择。

数组的流式风格

启用后，简短简单的数组将写在单行中：[item1, item2, item3]，而不是带短横线的多行显示。这使得输出更紧凑，同时保持复杂结构的可读性。

文档开始标记

--- 标记表示 YAML 文档的开始。对于单个文档它是可选的，但当一个文件中包含多个 YAML 文档时它是必需的，某些工具也明确要求包含它。

JSON 与 YAML 对比

数据类型

两种格式都支持相同的基本类型：对象/映射、数组/列表、字符串、数字、布尔值和 null 值。此外，YAML 原生支持日期、时间戳和二进制数据。

语法差异

• 对象： JSON 使用 {"key": "value"}，YAML 使用 key: value
• 数组： JSON 使用 ["a", "b", "c"]，YAML 在单独的行中使用短横线前缀
• 字符串： JSON 必须使用双引号，YAML 通常不需要引号，除非字符串包含特殊字符
• 注释： JSON 没有注释语法，YAML 使用 # 注释内容

常见问题解答

JSON 和 YAML 有什么区别？

JSON（JavaScript 对象表示法）使用大括号、中括号和引号来构建结构，而 YAML（YAML 不是标记语言）使用缩进和极少的标点符号。YAML 的可读性更高并支持注释，因此在配置文件中非常流行。JSON 则更通用，适用于数据交换和 API。

为什么要将 JSON 转换为 YAML？

在 DevOps 工具（如 Kubernetes、Docker Compose、Ansible）和 CI/CD 流水线（GitHub Actions、GitLab CI）中，YAML 是配置文件的首选格式。将 JSON 转换为 YAML 可以使配置更具可读性，允许添加注释，并减少括号和引号带来的视觉干扰。

此转换器对敏感数据安全吗？

是的，所有转换都在您的浏览器和我们的安全服务器上进行。我们不会存储或记录您的任何 JSON 数据。对于高度敏感的数据，为了获得最大程度的安全性，您可以使用离线转换器或命令行工具。

我可以将 YAML 转换回 JSON 吗？

是的，我们也提供 YAML 转 JSON 转换器工具。转换是双向的，但由于 JSON 不支持注释，转换回 JSON 时，某些 YAML 特有的功能（如注释）将会丢失。

YAML 中的流式风格（flow style）是什么？

YAML 中的流式风格使用类似于 JSON 的中括号和大括号来紧凑地表示简单的数组和对象。例如，使用 [item1, item2, item3] 而不是带短横线的多行显示。我们的转换器可以选择对短数组使用流式风格，使输出更紧凑。

技术备注

支持的 JSON 特性

• 标准 JSON 语法（符合 RFC 8259 标准）
• 任何深度的嵌套对象和数组
• 所有原始类型：字符串、数字、布尔值、null
• 字符串中的 Unicode 字符
• 字符串中的转义字符

YAML 输出特性

• 兼容 YAML 1.2 的输出
• 正确的基于缩进的结构
• 对特殊字符自动加引号
• 使用字面量块标量 (|) 处理多行字符串
• 简单数组的可选流式风格

更多资源

详细了解 JSON 和 YAML 格式：

• YAML 官方规范
• JSON 官方规范
• Kubernetes 对象管理