开发者工具

YAML验证器

粘贴 YAML 代码后,可以检查语法错误、缩进问题、缺少冒号、数组结构问题,并查看 JSON 转换结果。

YAML 语法验证 快速检查 Docker Compose、GitHub Actions、Kubernetes 配置文件中的语法错误。
错误位置检查 通过解析错误信息检查缩进、冒号、引号等问题。
支持 JSON 转换 将有效的 YAML 转换为 JSON,以便更清楚地查看结构。

YAML 输入

请在下方粘贴要验证的 YAML 代码。

语法验证标准 在浏览器中解析输入的 YAML,检查语法错误和结构错误。
结构检查 验证成功后,会同时提供 JSON 转换结果,便于检查对象和数组结构。
0行 0字 键 0个 等待验证

验证结果

可以查看 YAML 语法状态、错误信息和 JSON 转换结果。

待机中
请输入 YAML 代码后点击验证按钮。

YAML 使用示例

YAML 常用于配置文件,缩进和结构非常重要。

Docker Compose

在包含 services、volumes、networks 等多层级结构的配置文件中,经常使用 YAML 语法。

GitHub Actions

workflow、jobs、steps、uses、run 等自动化设置通常用 YAML 编写。

Kubernetes

Deployment、Service、ConfigMap 等资源定义文件广泛使用 YAML 格式。

使用指南

区分YAML语法与应用配置规则

解析YAML、查看错误位置,并可显示JSON和键数。语法通过不代表Docker Compose、Kubernetes或CI配置符合对应规则。

适用人群

  • 编辑配置文件的开发者
  • 检查YAML数据类型的用户

使用场景

  • 定位缩进错误。
  • 比较布尔值、数字、字符串和数组。

从输入到检查结果

  1. 1

    移除秘密信息,准备单个YAML文档。

  2. 2

    粘贴不超过200,000字符的内容。

  3. 3

    选择需要的JSON与统计选项。

  4. 4

    检查错误行列或解析后的内容。

  5. 5

    语法检查后,再运行目标应用自身的验证。

使用示例 1

简单映射

输入
name: demo ports: - 8000
结果
得到含name以及ports数组的对象,数组元素为8000。

除了成功提示,还要检查解析后的类型。

使用示例 2

语法正确但配置错误

输入
services: web: imag: nginx
结果
image键拼错,YAML语法仍可能通过。

需要应用专用的结构验证发现此类问题。

计算与处理原理

页面加载js-yaml 4.3.0,将合并键总数限制为10,000。解析后按唯一对象或数组节点遍历,限制为50,000节点、深度100。JSON转换为可选功能。

限制与注意事项

  • 解析器与目标应用可能以不同方式解释类型。
  • 多文档流需要分别处理。
  • 循环别名可以是有效YAML,但无法表示为普通JSON。
  • 资源限制会限制可处理的大小和复杂度。
数据处理

输入在本地解析。解析库从外部CDN加载,但YAML文本不会发送给该CDN。

常见问题

绿色结果也验证Compose设置吗?

不会。Compose专用验证应使用docker compose config。

有效YAML为什么无法转换JSON?

循环别名结构无法序列化为普通JSON。

为什么有些错误提示是英文?

库的诊断保留原文,周围的标签与操作说明使用所选语言。