📑
YAML 语法速查
缩进、列表、多行文本与锚点等 YAML 语法要点与常见坑。
本地处理 · 不上传
加载工具中…
相关：YAML · 语法 · 缩进 · 锚点 · 多行字符串 · 配置
缩进、列表、多行文本与锚点等 YAML 语法要点与常见坑。缩进敏感与隐式类型转换是 YAML 最容易出问题的两处，配置写错往往难以察觉。
使用步骤
- 先确定层级结构，用空格缩进而不是制表符
- 按列表、映射、多行文本分类找写法
- 注意 yes、no、on 这类值会被解析成布尔
- 写完用解析器校验一遍，缩进错误最难肉眼发现
使用场景
- 编写配置文件
- 排查解析错误
- 理解 YAML 的类型转换
- 查阅语法写法
小贴士
- YAML 严禁用 Tab 缩进，只能用空格。绝大多数解析报错都源于缩进不一致或 Tab 混入。
- 缩进必须用空格不能用 Tab，混用是解析失败最常见的原因，且肉眼很难分辨。
- yes、no、on、off 会被解析成布尔值，国家码 NO、版本号 1.0 也会被转换类型，需要用引号保护。
常见问题
为什么解析报错？
最常见的是缩进问题——用了 Tab、或者同级缩进的空格数不一致。开启编辑器的显示空白字符功能能立刻看出问题。其次是特殊字符（冒号、井号）未加引号。
为什么值的类型不对？
YAML 会做隐式类型推断：yes/no/on/off 变成布尔、1.0 变成数字、日期格式的字符串变成日期。需要保持字符串必须加引号，这是配置出错的常见来源。
多行文本怎么写？
用竖线保留换行，用大于号折叠成一行。两者后面还可以加减号或加号控制末尾换行的处理。写脚本片段或长文本时这两个符号很实用。
YAML 语法速查是免费的吗？
是。本站所有工具完全免费，无需注册登录、无广告干扰，打开即用。
使用YAML 语法速查，我的数据安全吗？
安全。该工具在你的浏览器本地完成处理，输入内容不会上传到服务器，隐私更有保障。