基础设施即代码 / 知识点
YAML 语法速查手册
多行字符串与 Chomping
|+ / >+保留结尾换行和额外空行。
Keep Chomping +
保留结尾换行和额外空行。
所属主题
多行字符串与 Chomping
语法 / 形式
|+ / >+推荐示例
text: |+
hello
关键边界
需要精确保留文本尾部空行时使用。
|2 / >2显式指定 block scalar 内容缩进级别。
显式缩进指示符
显式指定 block scalar 内容缩进级别。
所属主题
多行字符串与 Chomping
语法 / 形式
|2 / >2推荐示例
text: |2
hello关键边界
大多数配置不需要,只有自动推断不合适时使用。
|2- / >2-缩进指示符和 chomping indicator 可组合。
Chomping + 缩进组合
缩进指示符和 chomping indicator 可组合。
所属主题
多行字符串与 Chomping
语法 / 形式
|2- / >2-推荐示例
text: |2-
hello关键边界
低频高级语法;可读性优先。
|内容中额外缩进会成为字符串内容的一部分。
Block Scalar 保留更深缩进
内容中额外缩进会成为字符串内容的一部分。
所属主题
多行字符串与 Chomping
语法 / 形式
|推荐示例
text: |
line1
indented
line2关键边界
常见于嵌入代码块。
>折叠样式中的空行可形成段落换行。
Folded Block 中的空行
折叠样式中的空行可形成段落换行。
所属主题
多行字符串与 Chomping
语法 / 形式
>推荐示例
text: >
first paragraph.
second paragraph.关键边界
不是所有换行都简单变成空格。
|多行 shell 脚本优先 literal style。
多行命令使用 Literal
多行 shell 脚本优先 literal style。
所属主题
多行字符串与 Chomping
语法 / 形式
|推荐示例
command: |
set -e
echo start
./run.sh关键边界
若运行器最终把 scalar 交给 shell,是否同一 shell 会话仍由上层应用决定。
类型、Schema 与显式 Tag
true / True / TRUEYAML 1.2 core schema 可解析为布尔 true。
Boolean True
YAML 1.2 core schema 可解析为布尔 true。
所属主题
类型、Schema 与显式 Tag
语法 / 形式
true / True / TRUE推荐示例
enabled: true关键边界
工程配置建议统一小写 true。
false / False / FALSEYAML 1.2 core schema 可解析为布尔 false。
Boolean False
YAML 1.2 core schema 可解析为布尔 false。
所属主题
类型、Schema 与显式 Tag
语法 / 形式
false / False / FALSE推荐示例
enabled: false关键边界
工程配置建议统一小写 false。
yes / no在 YAML 1.2 core schema 中不再是标准布尔词。
YAML 1.2 中 yes/no
在 YAML 1.2 core schema 中不再是标准布尔词。
所属主题
类型、Schema 与显式 Tag
语法 / 形式
yes / no推荐示例
answer: yes关键边界
老 YAML 1.1 解析器可能把 yes/no 解析成 Boolean;跨工具时最好给业务字符串加引号。
on / off在 YAML 1.2 core schema 中不作为标准 Boolean。
YAML 1.2 中 on/off
在 YAML 1.2 core schema 中不作为标准 Boolean。
所属主题
类型、Schema 与显式 Tag
语法 / 形式
on / off推荐示例
mode: 'on'关键边界
旧 YAML 1.1 解析器可能按布尔解析,建议字符串加引号。
123 / -42 / +7表示整数。
十进制整数
表示整数。
所属主题
类型、Schema 与显式 Tag
语法 / 形式
123 / -42 / +7推荐示例
replicas: 3关键边界
解析后的具体数值类型由宿主语言决定。
0x<HEX>YAML core schema 支持十六进制整数。
十六进制整数
YAML core schema 支持十六进制整数。
所属主题
类型、Schema 与显式 Tag
语法 / 形式
0x<HEX>推荐示例
mask: 0xFF关键边界
若业务只需要文本,应该加引号。
0o<OCTAL>YAML 1.2 使用 0o 前缀表示八进制。
八进制整数
YAML 1.2 使用 0o 前缀表示八进制。
所属主题
类型、Schema 与显式 Tag
语法 / 形式
0o<OCTAL>推荐示例
mode: 0o755关键边界
不要沿用 YAML 1.1 的裸前导零八进制习惯。
1.5 / -0.25 / 1e3表示浮点值。
浮点数
表示浮点值。
所属主题
类型、Schema 与显式 Tag
语法 / 形式
1.5 / -0.25 / 1e3推荐示例
ratio: 0.75关键边界
不同宿主语言存在精度范围差异。
.inf / -.infYAML core schema 可表示正/负无穷。
Infinity
YAML core schema 可表示正/负无穷。
所属主题
类型、Schema 与显式 Tag
语法 / 形式
.inf / -.inf推荐示例
limit: .inf关键边界
JSON 等目标格式没有直接等价值,跨格式转换前确认。
.nan表示非数值浮点特殊值。
NaN
表示非数值浮点特殊值。
所属主题
类型、Schema 与显式 Tag
语法 / 形式
.nan推荐示例
value: .nan关键边界
很多数据库/JSON API 不接受 NaN。
null / Null / NULL / ~ / emptycore schema 下可解析为空值。
Null Forms
core schema 下可解析为空值。
所属主题
类型、Schema 与显式 Tag
语法 / 形式
null / Null / NULL / ~ / empty推荐示例
value: null关键边界
工程实践推荐统一显式 null,减少阅读歧义。
!!str <VALUE>强制节点使用 YAML 标准 string tag。
显式字符串 Tag
强制节点使用 YAML 标准 string tag。
所属主题
类型、Schema 与显式 Tag
语法 / 形式
!!str <VALUE>推荐示例
version: !!str 00123关键边界
适合必须阻止隐式类型解析的高级场景;普通配置加引号更易读。
!!int <VALUE>显式标记整数。
显式整数 Tag
显式标记整数。
所属主题
类型、Schema 与显式 Tag
语法 / 形式
!!int <VALUE>推荐示例
count: !!int 42关键边界
应用解析器必须支持对应标准 tag。
!!bool <VALUE>显式标记布尔节点。
显式布尔 Tag
显式标记布尔节点。
所属主题
类型、Schema 与显式 Tag
语法 / 形式
!!bool <VALUE>推荐示例
enabled: !!bool true关键边界
通常没有必要,普通 true 已足够。