工具说明
选择转换方向后,把 YAML 或 JSON 粘贴到输入区,页面会在停止输入后自动检查格式。也可以点击“校验格式”立即检查,并把输入光标定位到问题附近。
工具支持 YAML 转标准 JSON,也支持标准 JSON 转 YAML。属性顺序和大整数原始值会尽量保持,处理过程只在当前浏览器中完成,输入内容和转换结果不会上传或保存。
如何使用
转换 YAML 键名风格
在“YAML → JSON”方向,可以点击“小驼峰”“中划线”或“下划线”,递归转换 YAML 中的字符串键名。例如 user_name、user-name 和 UserName 可以统一为 userName、user-name 或 user_name。
键名转换不会修改对应的值、注释、锚点和别名。包含 .、/、: 等特殊符号的键会保持不变,避免改坏域名、路径或配置标识;如果转换后会产生重复键,工具会停止修改并指出冲突位置。
YAML 转 JSON
选择“YAML → JSON”,输入单个 YAML 文档,再选择 JSON 结果的缩进方式。点击“转换为 JSON”后,结果区会显示标准 JSON。
YAML 注释不会出现在结果中,因为标准 JSON 不支持注释。锚点和别名会在转换时展开;如果内容包含循环别名、自定义标签、非字符串对象键、NaN 或 Infinity 等标准 JSON 无法表达的值,页面会停止转换并说明原因。
JSON 转 YAML
选择“JSON → YAML”,输入标准 JSON,再选择 YAML 结果使用 2 个或 4 个空格缩进。JSON 输入不接受注释、尾逗号或单引号字符串。
转换结果使用 YAML 1.2 规则生成,不会使用 Tab 作为缩进。点击“转为输入并反向”可以把当前结果放回输入区,并切换转换方向继续检查。
校验格式
自动校验和“校验格式”按钮只检查语法以及当前工具支持的单文档范围,不会检查 Kubernetes、GitHub Actions 或其他业务配置规则。
遇到错误时,页面会显示行号、列号和原因。YAML 中最常见的问题包括缩进层级不一致、使用 Tab 缩进、重复键、无效别名和一次输入多个文档。
YAML 1.2 与数据类型
工具按 YAML 1.2 处理没有显式版本指令的内容。例如 yes、no、on 和 off 默认作为普通字符串,而不是布尔值。
YAML 能表达的数据类型比 JSON 更多。为了避免无提示地改变数据,只有能够明确表示为标准 JSON 的内容才会完成 YAML 转 JSON。
常见问题
支持多个 YAML 文档吗?
目前不支持。一次输入只能包含一个 YAML 文档;使用多个 --- 分隔的文档会被标记为错误。
YAML 注释可以转换到 JSON 吗?
不可以。标准 JSON 没有注释语法,因此 YAML 中以 # 开头的注释不会写入 JSON 结果。
大整数会不会失去精度?
不会。转换过程不会先把整数变成普通 JavaScript Number 再输出,超出安全整数范围的整数仍会保留原始数值。
这是配置文件 Schema 校验器吗?
不是。本工具只检查 YAML 或 JSON 语法,不判断字段名称、必填项或业务规则是否符合某个平台要求。
输入内容会上传吗?
不会。校验、转换和复制都在当前浏览器中完成,输入内容不会发送到服务器。