Why does my YAML fail to parse?

Almost always indentation: a tab character (YAML forbids tabs for indentation) or sibling keys at inconsistent depths. A formatter rewrites everything to a single space-based width, which surfaces and fixes most of these.

YAML 修复 — 在线校验并格式化 YAML

input.yaml

user:
  id: 42
  name: Ada Lovelace
  active: true
  roles:
    - admin
    - editor
plan: pro
limits:
  requests: 5000
  storage_gb: 20

output.yaml缩进排序键

校验并格式化 YAML，或将其转换为 JSON。

与 YAML Fix 相关的指南

全部指南 →

指南

JSON 互操作：YAML、CSV、XML、JWT、Schema

JSON 很少独立存在。在 JSON 与 YAML/CSV/XML 之间转换，解码 JWT，生成类型，并根据 JSON Schema 校验 —— 每一步都留在浏览器中。

指南

将 YAML 转为 JSON（并避免缩进错误）

自 YAML 1.2 起，任何 JSON 文档都是合法的 YAML。将 YAML 配置转为 JSON，并留意缩进与类型推断陷阱。

指南

在发起 API 请求前校验 JSON

在发送 API 请求前做一次快速校验，可以把 JSON 语法问题与认证、Schema、后端错误清晰地区分开。

YAML 校验与格式化工具

贴上 YAML 即可立即检查语法错误。校验器会高亮出错的精确所在行。你也可以用一致的缩进重新格式化 YAML，或者一键转换为 JSON。

同一个工具可以充当 yaml lint / yaml linter /** yamllint** / yaml checker /** online yaml validator** —— 贴上任意 YAML，它都会以行和列的形式报告第一个解析失败。把它当作 validate yaml online 来用：格式化、lint 与转换都在本地完成，不会上传任何内容。

YAML 与 JSON： 二者都是数据交换格式，YAML 1.2 是 JSON 的严格超集，因此任何 JSON 文档本身就是合法的 YAML。两者的实际差别在形态 —— YAML 使用缩进，并且对注释友好（适合人工编辑的配置），JSON 使用括号且语法严格（适合 API）。当你需要把配置喂给只接受 JSON 的工具时，点击 To JSON。

Validate —— 严格的 YAML 1.2 解析，可精确报告错误的行 / 列
Format YAML —— 把缩进（2 个空格）与键序规范化
Convert to JSON —— 输出有效、漂亮缩进的 JSON，可直接用于 API

常见的 YAML 错误

用了 Tab 而不是空格

YAML 不允许用 Tab 缩进。请把所有 Tab 替换为空格。

缩进不一致

同一父键下的子键，必须相对父键缩进相同数量的空格。

未加引号的特殊字符

以 :、- 或 # 开头的值，往往需要用引号包起来。

FAQ

为什么我的 YAML 解析失败？

几乎都是缩进问题：要么混入了 Tab（YAML 不允许用 Tab 缩进），要么同级的键深度不一致。格式化器会把所有内容重写成单一的、基于空格的宽度，这通常能把大部分这类问题暴露出来并修好。