JSON to YAML Converter可以处理什么？
JSON 与 YAML 转换适用于对象、数组及兼容 JSON 的标量。选择方向后粘贴一份完整文档，转换器使用本地解析器生成结果，并报告输入语法错误。YAML 注释和原始排版不会保留。
何时适合往返转换？
仅需要数据值时，可以用 JSON 与 YAML 往返转换；如果需要保留注释、锚点写法、自定义标签或标量样式，应保留原始 YAML，不把 JSON 当作无损中间格式。
如何使用？
- 在“操作”中选择 JSON → YAML 或 YAML → JSON。
- 粘贴一份完整文档，然后点击“转换”。
- 检查输出类型和内容，复制或下载结果；需要保留注释时请另外保留源文件。
实际输入输出示例
将对象转换为 YAML 配置
输入
{"project":"KitLumi","private":true}输出
project: KitLumi
private: true
字符串与布尔值保留其数据含义，但输出采用 YAML 的排版方式。
常见错误与修复方法
| 现象 | 可能原因 | 修复方法 |
|---|---|---|
| JSON → YAML 提示语法错误。 | 严格 JSON 不允许单引号、注释或尾逗号。 | 先修正为有效 JSON，再重新转换。 |
| YAML 转换失败或注释消失。 | 输入可能有缩进问题、多份文档或循环别名；JSON 也不支持注释。 | 只输入一份文档，检查缩进；需要注释时保留原始 YAML。 |
YAML 与 JSON 的边界
JSON 不保存 YAML 注释、锚点语法、别名写法和自定义标签。多文档 YAML 需要逐份转换。解析后的数字可能受 JavaScript 数值精度限制，大整数标识符应使用字符串。
标准与实现参考
- YAML 1.2.2 规范 (opens in a new tab)说明 YAML 标量、集合、锚点和标签。
- js-yaml 官方实现 (opens in a new tab)说明 load 单文档解析和 dump 序列化行为。
关于JSON ↔ YAML的常见问题
是否支持双向转换？
支持。在操作菜单切换 JSON → YAML 和 YAML → JSON。
YAML 注释会保留吗？
不会。JSON 没有注释表示方式，转换也不保留原始排版。
可以转换多文档 YAML 吗？
此工具使用单文档解析，请将多份文档分别转换。
配置内容会发送到服务器吗？
不会。解析、转换、复制和下载均在浏览器本地完成。
更新记录
补充完整中文转换步骤、输入输出示例、单文档要求、数字精度与注释限制，并改善加载状态及复制下载交互。