什么是 YAML 转 JSON 转换器？

YAML 转 JSON 转换器是一款功能强大的浏览器工具，可将 YAML（YAML Ain't Markup Language）数据转换为 JSON（JavaScript Object Notation）格式。它提供实时转换功能，支持语法高亮和多种视图模式，帮助您高效处理数据。

隐私优先：所有处理都在您的浏览器中进行。您的数据永远不会离开您的设备，我们不收集或存储任何信息。

为什么要将 YAML 转换为 JSON？

YAML 和 JSON 都是流行的数据序列化格式，但在现代开发工作流中用途不同。了解何时在两者之间转换有助于优化您的开发流程：

API 集成

大多数 REST API 期望请求和响应体采用 JSON 格式。将 YAML 配置转换为 JSON 可实现无缝的 API 通信。

JavaScript/Web 开发

JSON 在 JavaScript 和 Web 浏览器中原生支持，是客户端数据处理和 Web 应用的首选格式。

配置迁移

当其他工具或部署平台需要时，将 YAML 配置文件（Docker Compose、Kubernetes、CI/CD 管道）转换为 JSON。

数据处理

许多编程语言和库对 JSON 的支持更好，具有内置解析功能，使数据操作更高效。

Table of Contents

1. 什么是 YAML 转 JSON 转换器？
- 1.1. 为什么要将 YAML 转换为 JSON？
2. 使用方法
3. 功能特性
4. 常见问题

使用方法

基本转换

输入 YAML

在左侧面板粘贴或输入您的 YAML 数据。编辑器支持行号、语法高亮和 Tab 键缩进，便于编辑。

查看 JSON

转换后的 JSON 会立即显示在右侧面板，并带有彩色语法高亮。您可以在文本视图和树形视图之间切换来浏览数据。

复制或下载

使用工具栏按钮将 JSON 复制到剪贴板，或将其下载为 .json 文件以在您的项目中使用。

格式化选项

缩进大小

选择最适合您需求的缩进级别：

2 个空格 - 紧凑且节省空间
4 个空格 - 大多数项目的标准
8 个空格 - 最大可读性
最小化 - 无空格的最小化输出

排序键

组织您的 JSON 输出以提高可读性：

按字母顺序排列所有对象键
便于比较数据结构
原始 YAML 保持不变
可随时切换开关

查看输出

文本视图

原始 JSON 显示

语法高亮的 JSON 代码
彩色编码的键、值和类型
便于参考的行号
易于复制和粘贴

树形视图

交互式结构

可折叠的嵌套对象和数组
清晰的视觉层级表示
每个节点的项目计数
轻松浏览大型数据

文件操作

上传 - 点击上传按钮从您的设备加载 .yml 或 .yaml 文件进行即时转换
下载 - 将转换后的 JSON 保存为 .json 文件到您的本地系统
示例 - 加载示例 Docker Compose 配置，查看工具的实际效果并探索其功能

功能特性

实时转换

转换器在您输入时处理 YAML 输入，具有智能性能优化。粘贴数据会触发即时转换，而输入时会有短暂延迟以保持流畅性能。

即时错误检测：无效的 YAML 会立即被检测到，错误消息会显示问题的确切行号和列号，帮助您快速修复问题。

语法高亮

JSON 输出使用专业的彩色语法高亮来提高可读性，帮助您快速识别不同的数据类型：

元素	颜色	描述	示例
键	紫色	对象属性名称	`"name":`
字符串	绿色	文本值	`"example"`
数字	橙色	数值	`42`
布尔值	蓝色	真/假值	`true`
Null	灰色	Null 值（斜体）	`null`
括号	灰色	结构字符	`{ } [ ]`

交互式树形视图

树形视图提供了 JSON 结构的强大可折叠可视化，使探索复杂的嵌套数据变得容易：

视觉层级

一目了然地查看数据的完整结构，具有清晰的父子关系。

点击展开/折叠

点击任何对象或数组节点以显示或隐藏其子项，专注于您需要的数据。

项目计数

每个节点显示其包含的项目数，帮助您了解每个级别的数据大小。

行号和错误检测

编辑器包含专业的开发功能来增强您的工作流：

同步的行号在滚动时保持可见
错误行的红色高亮便于快速识别
详细的错误消息，包括行号、列号和描述
支持 Tab 键插入空格并保持缩进

错误处理：当 YAML 包含语法错误时，特定的错误行会以红色高亮显示，编辑器下方会显示详细的错误消息，帮助您快速修复问题。

常见问题

支持哪些 YAML 功能？

转换器支持标准 YAML 1.2 功能，包括：

对象和嵌套结构
数组和列表
字符串（单行和多行）
数字（整数和浮点数）
布尔值（真/假）
Null 值
注释（转换时被删除）

该工具使用 js-yaml 库，完全实现 YAML 1.2 规范，确保准确可靠的转换。

YAML 注释会发生什么？

YAML 注释（以 # 开头的行）在转换时被忽略，因为 JSON 不支持注释语法。只有实际的数据值会包含在 JSON 输出中。

注意：如果您需要保留文档，请考虑在转换前将其作为特殊键添加到数据结构中（例如"_comment"或"description"）。

可以转换多文档 YAML 吗？

当多个文档由 --- 分隔时，转换器处理第一个 YAML 文档。对于多文档 YAML 文件，您可能需要分别转换每个文档。

解决方案：逐个复制每个文档部分并转换，或在转换前将它们合并为单个 YAML 数组结构。

转换准确吗？

是的，完全准确。转换器使用 js-yaml 库，完全支持 YAML 1.2 规范。数据类型准确保留：

字符串保持为字符串
数字转换为 JSON 数字
布尔值变为 true/false
Null 值转换为 null
嵌套结构保持其层级

对于 JSON 支持的所有标准 YAML 数据类型，转换是无损的。

最大文件大小是多少？

由于所有处理都在您的浏览器中进行，实际限制取决于您设备的内存和处理能力。该工具可以很好地处理几兆字节的文件。

最佳性能最多 1 MB

可能出现延迟 1-5 MB

对于非常大的文件，您可能会在转换期间经历短暂延迟，但该工具仍会成功处理它们。

"排序键"会改变我的原始 YAML 吗？

不会。"排序键"选项仅影响 JSON 输出。您输入面板中的原始 YAML 完全保持不变。

随时关闭它以恢复原始键顺序。当您需要比较 JSON 结构或在不同文件中保持一致的键顺序时，此功能很有用。