YAML 语法验证器
在线验证 YAML 语法,精准定位错误行号和列号,验证成功后预览解析结构。免费,纯浏览器端运行,数据不离开本地。
使用方法
- 将 YAML 内容粘贴到文本框中。
- 点击 Validate 按钮(或按 Ctrl+Enter)。
- 若 YAML 合法,显示绿色成功提示,并在下方展示解析后的 JSON 结构。
- 若 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 内容不会离开本地设备。