准备工作
使用本工具前,您需要准备以下内容:
- 一段需要转换的 YAML 格式文本内容
- 现代浏览器(Chrome、Firefox、Edge、Safari 均可,推荐 Chrome 最新版)
- 确保浏览器 JavaScript 功能已启用(默认已开启)
基础转换步骤
第一步:打开工具页面
访问 ud5.com 网站,搜索「YAML转JSON」或直接通过工具列表找到本工具并打开。页面加载后会显示左右分栏的操作界面。
第二步:输入 YAML 内容
在左侧编辑区域中粘贴您的 YAML 内容。您可以直接从配置文件中复制粘贴,也可以手动输入。工具支持常见的 YAML 语法格式,包括块序列(使用 - 符号)和流序列(使用方括号)两种风格。
第三步:查看转换结果
输入 YAML 内容后,右侧会实时显示转换后的 JSON 结果。转换是即时发生的,无需点击任何按钮。如果 YAML 内容存在语法错误,右侧会显示红色的错误提示信息,包括具体的行号和错误描述。
第四步:复制或导出结果
转换完成后,点击「复制」按钮即可将 JSON 结果复制到剪贴板。您也可以点击格式化/压缩切换按钮,选择合适的输出格式:格式化输出适合阅读和调试,压缩输出适合直接用于配置文件。
进阶技巧
处理锚点和别名
YAML 的锚点(anchor)和别名(alias)是一种强大的数据复用机制。在 YAML 中,您可以使用 & 符号定义一个锚点,然后在其他位置使用 * 符号引用它。本工具会正确解析这些引用关系,在 JSON 输出中将别名替换为实际的数据内容。
示例:当 YAML 中定义了 defaults: &default {timeout: 30},然后在其他配置中使用 *default 引用时,工具会自动将引用展开为完整的数据对象。
合并键(Merge Key)处理
合并键 << 是 YAML 中用于对象合并的特殊语法。它允许您将一个或多个锚点的键值对合并到当前对象中。本工具支持单个合并键和多个合并键的场景,会按照 YAML 规范的优先级规则正确处理键的覆盖关系。
多行字符串转换
YAML 支持多种多行字符串语法,包括字面量块(| 保留换行)和折叠块(> 将换行转为空格)。本工具会将这些语法正确转换为 JSON 中的字符串,保留原始的换行和格式信息。注意转换后的 JSON 字符串中换行符会显示为 \n 转义序列。
故障排除
如果粘贴 YAML 后右侧没有显示结果,请检查:① YAML 内容是否为空或只包含注释 ② 是否存在语法错误导致解析失败 ③ 浏览器控制台是否有 JavaScript 错误
YAML 对缩进非常敏感,错误提示通常会指出具体的行号。请确保:① 使用空格而非 Tab 缩进 ② 缩进层级保持一致(建议统一使用2或4个空格) ③ 列表项的 - 符号后有一个空格
如果 YAML 中包含冒号(:)、井号(#)、百分号(%)等特殊字符,可能需要使用引号包裹字符串值。如果遇到意外的解析错误,尝试给包含特殊字符的值加上单引号或双引号。
UD5工具箱