YAML 语法验证器

在线验证 YAML 语法,精准定位错误行号和列号,验证成功后预览解析结构。免费,纯浏览器端运行,数据不离开本地。

100% 浏览器端运行 数据不离开你的设备 免费 · 无需注册

使用方法

  1. 将 YAML 内容粘贴到文本框中。
  2. 点击 Validate 按钮(或按 Ctrl+Enter)。
  3. 若 YAML 合法,显示绿色成功提示,并在下方展示解析后的 JSON 结构。
  4. 若 YAML 不合法,错误框中显示错误原因、行号、列号及问题代码片段。

错误输出说明

验证失败时,错误框包含以下信息:

  • 原因 — 错误的通俗描述(如 缩进错误流结束异常)。
  • 行号与列号 — 错误在输入中的精确位置。
  • 代码片段 — 解析器提供的上下文,通常包含指向问题字符的 ^ 标记。

常见 YAML 语法错误

  • 缩进不一致 — YAML 要求统一使用空格(禁止 Tab)缩进,同级混用 2 格和 4 格缩进会导致解析错误。
  • 键后缺少冒号key value 是非法的,正确写法为 key: value
  • 特殊字符未加引号 — 值中含有 :#[]{} 等字符时,需要用引号包裹或转义。
  • Tab 字符 — YAML 禁止用 Tab 缩进,应将所有 Tab 替换为空格。
  • 重复键 — 同一映射块中出现重复键在 YAML 1.2 规范中是非法的。

示例:合法 YAML

server:
  host: localhost
  port: 8080
  tls: true

database:
  driver: postgres
  name: myapp
  credentials:
    user: admin
    password: "s3cr3t"

allowed_origins:
  - https://example.com
  - https://api.example.com

示例:非法 YAML(缩进错误)

server:
  host: localhost
   port: 8080   # 错误:多余的空格导致缩进不一致

验证器会报告检测到缩进不一致的行号和列号,便于快速定位并修复问题。

FAQ

YAML 验证器能检查哪些问题?

工具使用 js-yaml 解析器(符合 YAML 1.2 规范)检查语法错误。缩进错误、非预期字符、重复键、缺少冒号等问题均可捕获,并精确报告错误所在的行号和列号。

和 YAML 转 JSON 工具有什么区别?

转换器假定输入合法并进行格式转换;而验证器专注于判断 YAML 语法是否正确,提供详细错误信息帮助修复问题。本工具面向「检查并修复 YAML 语法错误」的使用场景,而非格式转换。

「解析结构预览」是什么?

当 YAML 语法合法时,工具会将其解析为数据对象,并以格式化 JSON 形式展示,方便直观确认数据结构是否符合预期,也可复制 JSON 结果供其他地方使用。

支持哪个 YAML 规范版本?

工具使用 js-yaml 4.x,实现 YAML 1.2 规范,支持锚点、别名、多行字符串、块/流序列及显式类型标签等所有常用 YAML 语法。

数据会上传到服务器吗?

不会。验证完全在浏览器中通过 JavaScript 完成,YAML 内容不会离开本地设备。