就绪
YAML 输入 0 行
JSON 输出 0 行

常见问题与知识点

最常见的YAML错误包括:缩进不一致(混用空格和Tab、缩进空格数不一致)、重复键(同一层级出现相同的键名)、语法格式错误(如冒号后缺少空格、连字符位置不正确)、引号不匹配(单引号或双引号未闭合)。本工具会精确定位错误行号并高亮显示,帮助您快速修复。建议始终使用空格而非Tab进行缩进,并保持统一的缩进宽度(通常为2或4个空格)。

YAML 到 JSON 的数据类型映射规则:字符串→JSON字符串、整数/浮点数→JSON数字、布尔值(true/false/yes/no/on/off)→JSON布尔值、null/~→JSON null、数组(- 开头)→JSON数组、映射(键值对)→JSON对象。YAML中的注释(#开头)在转换时会被忽略。日期类型(如2023-01-01)默认转为字符串,若需保持日期类型需使用特定schema。

这通常是由不可见字符引起的:Tab字符与空格混用是最常见的罪魁祸首。YAML规范要求使用空格进行缩进,严格禁止Tab。此外,全角空格零宽字符、或从网页/PDF复制时带入的特殊Unicode空白字符也可能导致解析失败。建议使用编辑器的"显示空白字符"功能检查,或使用本工具的"清空"按钮后重新手打缩进。本工具的错误提示会指出具体行号,方便定位问题。

YAML优势:可读性极强、支持注释、引用和锚点、多文档支持、配置文件的理想选择(如Docker Compose、Kubernetes、Ansible)。JSON优势:解析速度快、生态广泛、所有编程语言原生支持、API数据交换标准格式、结构严格不易产生歧义。选择建议:人工编写和维护的配置文件推荐YAML;程序间数据交换和API通信推荐JSON。本工具帮助您在两者之间无缝转换。

YAML提供多种字符串书写方式:|(字面量块,保留换行)、>(折叠块,将换行转为空格)、|+ / |−(控制末尾换行)。包含特殊字符(如冒号、井号、引号)的字符串需要用单引号(不转义)或双引号(支持转义序列如\n、\t)包裹。JSON中则统一使用双引号,特殊字符需转义。转换时,本工具会自动处理这些差异,确保输出合法JSON。

当前版本主要针对单文档YAML进行校验和转换。如果您输入包含多个---分隔符的多文档YAML,工具会尝试转换第一个文档。如需处理多文档YAML,建议分别转换每个文档。未来版本将支持多文档YAML转换为JSON数组。您可以使用"示例"按钮查看标准YAML格式参考。