YAML 语法与示例
YAML 是最常用的配置文件格式。掌握下面这些规则，就能正确地读写 YAML。
基本元素
| 元素 | YAML 写法 | 含义 |
|---|---|---|
| 映射 | 名称: web | 一个键和它的值 |
| 嵌套映射 | 子键缩进 2 个空格 | 对象中的对象 |
| 列表 | - 第一项 | 列表中的一项 |
| 行内列表 | [a, b, c] | 写在一行的短列表 |
| 注释 | # 备注 | 程序会忽略 |
| 空值 | ~、null 或不写 | 没有值 |
多行文本
使用 | 会原样保留换行，适合脚本和证书。使用 > 会把多行合并成一段，适合长描述。在符号后加 -（|- 或 >-）可以去掉最后的换行。
锚点与多文档
- 在值前写 &名称 来标记它，之后用 *名称 复用。
- 用 <<: *名称 把复用的映射合并到另一个映射中。
- 一个文件中的多个文档用三个连字符（---）的行分隔。
- 如果工具需要明确的结束，可用 ... 结束文档。