YAML/YML在线格式化 - YAML美化压缩校验与JSON互转

YAML/YML在线格式化说明

本工具基于 yaml 库（YAML 1.2 规范），支持 YAML/YML 格式化美化、压缩为 JSON 单行、语法校验（含错误行列定位）、YAML 与 JSON 互转。YAML（YAML Ain't Markup Language）以缩进表示层级，比 JSON 更易读，广泛用于配置文件。所有处理均在浏览器本地完成，数据不上传服务器，保障数据安全。格式化后的 JSON 可继续用 JSON格式化 查看结构。

功能详解

YAML 格式化美化

将杂乱的 YAML/YML 文本按指定缩进（2空格或4空格）重新排版，使层级结构清晰可读。适用于 Docker Compose（docker-compose.yml）、Kubernetes 部署文件、GitHub Actions 工作流（.github/workflows/*.yml）等配置文件的查看与编辑。

YAML 压缩

将多行 YAML 压缩为 JSON 单行格式，去除注释和空白，减小文件体积，便于网络传输与 API 请求中嵌入。压缩后再通过 JSON→YAML 即可还原为 YAML 格式。

YAML 语法校验

检查 YAML 是否符合语法规范，若存在错误（如缩进不一致、Tab 和空格混用、冒号后缺少空格、非法字符等），返回具体错误信息及位置，帮助快速定位修复。建议编写 CI/CD 配置文件后先用本工具校验再提交。

YAML 与 JSON 互转

支持 YAML→JSON 和 JSON→YAML 双向转换。YAML 转 JSON 后可通过 JSON校验工具 交叉验证数据结构；JSON 转 YAML 适合将 API 返回的 JSON 转换为可读性更强的配置文件格式。

常见问题

如何检查 YAML 缩进错误？

使用本页的"校验"按钮即可。常见缩进错误包括：Tab 和空格混用（YAML 只允许空格缩进）、缩进层级不一致（如 2 空格和 4 空格混用）。YAML 对缩进极其敏感，一个缩进错误就可能导致整个文件解析失败。

YAML 转 JSON 后注释丢失怎么办？

这是正常现象——JSON 格式本身不支持注释。YAML 的注释（以 # 开头的内容）在转为 JSON 时会被自动丢弃。如果需要在 JSON 中保留说明信息，建议用键值对（如 "comment": "说明文字"）代替注释。

.yml 和 .yaml 文件有什么区别？

两者完全等价，没有任何功能差异。.yaml 是 YAML 官方推荐的扩展名，.yml 是历史遗留（早期 DOS 系统仅支持 3 字符扩展名）。本工具两种扩展名的文件均支持，输入 .yml 文件内容即可正常使用。

支持多文档 YAML（--- 分隔符）吗？

支持。本工具可解析用 --- 分隔的多文档 YAML 文件（常见于 Kubernetes 资源清单中），格式化后各文档之间仍以 --- 分隔。压缩和转 JSON 时会将多个文档合并为一个 JSON 数组。