无需登录 数据私有 本地保存

YAML在线验证工具 - 格式检查与错误定位

开发工具 验证工具 YAML 检查 验证
61
0
0
0
YAML 在线验证工具

格式检查 · 错误精确定位 · JSON 转换 · 格式化美化

1
检测到 Tab 字符，YAML 不允许使用 Tab 缩进，请使用空格缩进。
⏳ 等待验证

👆 点击 "验证" 按钮检查 YAML 语法

📋 验证通过后将显示 JSON 预览

常见问题与知识点

YAML（YAML Ain't Markup Language）是一种人类可读的数据序列化格式，使用缩进表示层级关系。它广泛用于：配置文件（如 Docker Compose、Kubernetes、Ansible）、CI/CD 管道（GitHub Actions、GitLab CI）、API 数据交换等场景。相比 JSON，YAML 更简洁易读，支持注释，但对缩进要求严格。

最常见错误包括：
① 缩进不一致——混用 Tab 和空格，或缩进空格数不一致；
② 缩进层级错误——子级缩进未对齐；
③ 冒号后缺少空格——key:value 应写为 key: value；
④ 重复键——同一层级出现相同的键名；
⑤ 多行字符串格式错误——未正确使用 | 或 > 指示符。

YAML 使用缩进表示结构，支持注释，更易读易写，适合配置文件和人机交互场景。JSON 使用花括号和方括号，严格且无歧义，适合机器间数据交换和 API 传输。YAML 是 JSON 的超集（有效的 JSON 也是有效的 YAML）。当需要人工频繁编辑配置文件时推荐 YAML；当数据需要跨系统传输时推荐 JSON。

修复缩进问题的步骤：
① 统一使用空格——确保整个文件使用空格（通常 2 个或 4 个空格）而非 Tab；
② 保持同级对齐——同一层级的键必须左对齐；
③ 子级递进一致——每深入一层增加固定数量的空格（推荐 2 空格）；
④ 使用本工具的"格式化"功能可自动修正缩进（但会丢失注释）。大多数代码编辑器也支持将 Tab 自动转换为空格。

YAML 提供两种多行字符串方式：
① 字面量块 |——保留换行符，适合写脚本或配置文件内容，每行换行都被保留；
② 折叠块 >——将换行符转换为空格，适合写长段落文字，最终呈现为单行（段落间空行保留换行）。
还可以使用 |- 或 >- 控制末尾换行符的保留与否。

语法正确不代表语义正确。可能原因：
① 类型问题——YAML 自动推断类型（如 yes/no 被解析为布尔值，001 被解析为数字），需加引号保护；
② 键名拼写错误——目标工具期望特定键名，拼写偏差导致配置被忽略；
③ 版本兼容性——YAML 1.1 和 1.2 在某些细节上不同（如布尔值定义）。建议用引号包裹可能产生歧义的值：version: "1.0"。
✅ 已复制到剪贴板
🔧 相关工具