结构化数据格式的特点与应用
在现代软件开发与系统配置中，YAML、JSON 和 TOML 是最常见的三种结构化数据格式。每种格式因其独特的设计哲学，活跃于不同的应用场景中：
- JSON：作为 Web API 通信的事实标准，JSON 具有严格的结构和极高的解析效率，广泛应用于前后端数据交互。
- YAML：凭借极简的缩进层级和高可读性，常用于 CI/CD 流程、部署配置以及复杂的应用设置。
- TOML：专注于语义清晰的配置文件，其键值对和表（Table）的结构非常适合人类阅读和修改，常用于现代开发工具的配置管理。
在开发工作流中，工程师经常需要在这三者之间进行格式转换，例如将 API 返回的 JSON 片段转换为 YAML 以写入部署文件，或者将 TOML 配置迁移为 JSON。
转换器工作原理与规则
本转换器支持 YAML、JSON 和 TOML 之间的任意互转。用户只需在“输入格式”中选择源格式，在“输出格式”中选择目标格式，并在输入框中粘贴数据即可。
在转换过程中，转换器遵循以下核心规则与行为特征：
- 不保留注释与原始间距：转换器在读取输入数据时，会将其解析为内存中的数据对象，然后再按照目标格式重新生成。因此，输入数据中的注释、空行以及原始的间距排版在输出中均不会被保留。
- 缩进控制：对于 JSON 和 YAML 输出，用户可以调整“缩进”参数，选择使用 2 个或 4 个空格进行缩进。
- TOML 的顶层限制：根据 TOML 规范，TOML 文档必须拥有一个顶层表（Top-level Table）。这意味着，如果输入数据是一个独立的字符串、数字或数组，它们可以被写成有效的 JSON 或 YAML，但无法被写成有效的 TOML 文档。
客户端本地处理与隐私保护
本工具的数据转换完全在用户的浏览器本地进行。你的 YAML、JSON 和 TOML 数据不会上传到 BroBroGo 服务器，所有解析与生成逻辑均在客户端运行，保障了数据的私密性。
常见错误与排查指南
在转换结构化数据时，可能会遇到以下提示或限制：
- 输入限制：输入内容必须在 2,000,000 个字符以内。如果超出此限制，工具会显示“输入内容太大了，请控制在
{max}个字符以内。”。 - 格式相同：如果输入格式和输出格式选择一致，工具会提示“请选择两个不同的格式。”。
- 空输入：在没有输入任何内容时尝试转换，会提示“请先粘贴一些输入。”。
- 解析失败：如果源数据存在语法错误，工具会根据格式分别提示“这个 JSON 无法解析。”、“这个 YAML 无法解析。”或“这个 TOML 无法解析。”。
- TOML 写入限制：若尝试将不含顶层对象的数据转换为 TOML，工具会提示“这份数据无法写成有效的 TOML。”。
- 超时：若数据过于复杂导致转换时间过长，工具会提示“这次转换耗时太久，请换一段更小的输入。”。
常见问题
支持哪些转换？
YAML、JSON 和 TOML 可以任意互转。转换前先选择输入格式和输出格式即可。
为什么有些值不能转成 TOML？
TOML 文件需要顶层表。单独的字符串、数字或数组可以转成 JSON 或 YAML，但不能写成有效的 TOML 文档。
注释会保留吗？
不会。转换器会读取数据值并写出一份干净的新文档，原来的注释和排版不会一起带过去。