素材阁

YAML 速查

共 24 条 YAML 语法与工具,涵盖基础语法、层级与集合、字符串与多行、锚点与合并、工具。 支持搜索与分类筛选,点击即可复制。

基础语法

用缩进表示层级,禁止用 Tab。

命令说明
键值对(冒号后要有空格)
注释
文档开始;... 表示结束
字符串 / 数字 / 布尔 / 浮点
值为空的键(null)

层级与集合

映射与序列。

命令说明
嵌套映射(缩进两个空格)
列表(- 后面有空格)
行内列表与映射
对象列表
行内映射

字符串与多行

多行与引号规则。

命令说明
保留换行的块字符串
折叠换行的块字符串(成一行加空格)
单引号:不转义
双引号:支持转义
>-/|- 去掉末尾换行

锚点与合并

复用与合并片段。

命令说明
定义锚点 &def
合并锚点并覆盖字段
引用锚点
标签语法(用于 CloudFormation 等)

工具

校验与转换。

命令说明
YAML 语法与风格检查
yq:像 jq 一样查询 YAML
YAML 转 JSON
Python 安全解析
k8s 配置的校验(dry-run)

使用说明

YAML 速查:基础语法、层级与集合、字符串与多行、锚点与合并、工具;支持搜索与分类筛选,点击即可复制。

  1. 按用途点分类:基础语法、层级与集合、字符串与多行、锚点与合并、工具。
  2. 点「命令」列复制到配置文件或终端。
  3. 统一用空格缩进(禁止 Tab),冒号后务必留一个空格。
  4. 需要复用配置片段时用锚点 & 定义、* 引用、<< 合并。

常见问题

为什么总报缩进错误?
YAML 不允许用 Tab 缩进,且同级必须对齐;把编辑器切为空格并把 Tab 替换为空格即可。
| 和 > 有什么区别?
| 保留换行(每行一行),> 把换行折叠成空格(整段成一行);加 - 可去掉末尾换行。
需要联网吗?
不需要,本地可用。

延伸阅读

相关工具