YAML 在线格式化与校验工具

YAML 格式化、美化与校验工具

这款 YAML 格式化工具直接在你的浏览器中完成美化、压缩和校验。粘贴一份 Kubernetes 清单、Docker Compose 文件、GitHub Actions 工作流或 Ansible 剧本，即可得到缩进规范、整洁清晰的输出，并即时检查错误。

YAML 对缩进敏感的语法，让空格错误既容易写错又难以发现。本工具会统一缩进、精确到行号和列号标出语法错误，还能把嵌套结构展开成可交互的树形 — 让你的配置文件始终易读、可部署。

隐私优先设计：所有解析和格式化都在你的浏览器中进行。你的 YAML 绝不会上传到服务器，因此用来处理敏感的配置文件也很安全。

如何格式化 YAML

添加你的 YAML

把 YAML 粘贴到左侧的输入编辑器，或使用上传文件载入 .yaml 或 .yml 文件。点击示例数据可放入一份 Kubernetes 部署配置来试用。

格式化或压缩

点击格式化，用规范缩进进行美化；或点击压缩，转换为紧凑的流式风格。格式化时，可选 2、4 或 8 个空格的缩进，以匹配你的项目。

查看校验结果

校验会在你输入或粘贴时自动运行。如果 YAML 无效，错误框会显示精确的行号和列号，对应行号会被高亮，状态栏则显示 YAML 无效。

浏览、复制或导出

切换到树形视图浏览结构，用排序键按字母顺序排列键，然后复制结果，或将其下载为 .yaml 文件。

功能特点

格式化与美化

把杂乱或已压缩的 YAML 变成整洁、缩进规范的代码，缩进可选 2、4 或 8 个空格。

压缩

将块状风格的 YAML 转换为紧凑的流式风格，在保留全部数据的同时缩减文件大小。

实时校验

输入时即获得即时反馈，错误精确到行号和列号。

语法高亮

对键、字符串、数字、布尔值、null、注释和文档分隔符进行配色区分。

可交互树形视图

把 YAML 当作可折叠的树形浏览，每个节点都带有类型标签和条目计数。

排序键

一键按字母顺序排列每个键 — 在格式化和压缩两种模式下都可用。

上传与下载

从你的设备载入 .yaml 或 .yml 文件，并把格式化后的输出保存为 .yaml 文件。

复制与示例

把格式化结果复制到剪贴板，或加载一份 Kubernetes 示例配置来测试。

实时状态栏

查看有效/无效指示，以及实时的行数、文件大小和键数量。

深色模式

内置舒适的深色主题，适合长时间编辑配置文件。

常见问题

如何在线格式化 YAML？

把 YAML 粘贴到输入编辑器，然后点击格式化。工具会把文档干净地重新缩进，并以语法高亮显示结果。无需安装、无需注册 — 打开页面即可格式化。

YAML 正确的缩进是 2 个还是 4 个空格？

YAML 并不强制规定具体的缩进大小 — 只要保持一致即可。2 个空格最为常见，尤其在 Kubernetes 和 Docker 配置中，4 个空格也被广泛使用。这里可选 2、4 或 8 个空格，以匹配你项目的风格规范。

如何修复 YAML 缩进错误？

把 YAML 粘贴进来，让校验器指出问题所在的行号和列号，待结构能够解析后点击格式化。格式化会用统一的缩进重写整份文档，一步即可清除大多数空格错误。

为什么 YAML 不能用 Tab 缩进？

YAML 规范禁止用 Tab 缩进，因为 Tab 的宽度并不固定，会让基于缩进的结构变得不可靠。请始终用空格缩进。在本编辑器中，按 Tab 键会插入与你所选缩进大小相匹配的空格。

如何校验 YAML 语法？

校验是自动进行的 — 当你输入或粘贴时，状态栏会显示 YAML 有效或 YAML 无效。出现错误时，提示信息会给出精确的行号和列号，并在行号栏中高亮该行，方便你直接跳转过去。

为什么格式化后我的注释被移除了？

格式化会把你的 YAML 解析成数据结构，再重新序列化输出。注释并不属于 YAML 的数据模型，因此在这一往返过程中不会被保留 — 这是 YAML 解析器的标准行为。

压缩具体做了什么？

压缩会把你的 YAML 从块状风格（带缩进）转换为流式风格，使用花括号和方括号。输出在保留全部数据的同时尽可能紧凑 — 很适合把 YAML 嵌入脚本，或缩减传输体积。

可以格式化包含多个 YAML 文档的文件吗？

本工具会处理输入中的第一个 YAML 文档。如果文件包含多个由 --- 分隔的文档，则只有第一个会被格式化。

这款 YAML 格式化工具免费且保护隐私吗？

是的。它可免费使用，并且完全在你的浏览器中用 JavaScript 运行。你的 YAML 绝不会发送到任何服务器，因此你可以放心地格式化和校验敏感的配置文件。