【YAML】一文掌握 YAML 的具体用法（YAML 备忘速查）
这是理解和编写 YAML 格式设置文件的快速参考备忘单。参考：
[*]YAML Reference Card (yaml.org)
[*]Learn X in Y minutes (learnxinyminutes.com)
[*]YAML lint online (yamllint.com)
[*]INI 格式设置文件备忘清单 (jaywcjlove.github.io)
[*]TOML 格式设置文件备忘清单 (jaywcjlove.github.io)
入门
介绍
YAML 是一种数据序列化语言，旨在供人类直接读写
[*]YAML 不允许利用制表符
[*]元素部门之间必须有空间
[*]YAML 区分巨细写
[*]以 .yaml 或 .yml 扩展名结束您的 YAML 文件
[*]YAML 是 JSON 的超集
[*]Ansible playbook 是 YAML 文件
标量类型
n1: 1 # 整数
n2: 1.234 # 浮点
s1: 'abc' # 字符串
s2: "abc" # 字符串
s3: abc # 字符串
b: false # 布尔类型
d: 2015-04-05 # 日期类型
↓ 等效的 JSON
{
"n1": 1,
"n2": 1.234,
"s1": "abc",
"s2": "abc",
"s3": "abc",
"b": false,
"d": "2015-04-05"
}
利用空格缩进。 元素部门之间必须有空间。
变量
some_thing: &VAR_NAME foobar
other_thing: *VAR_NAME
↓ 等效的 JSON
{
"some_thing": "foobar",
"other_thing": "foobar"
}
表明
# A single line comment example
# block level comment example
# comment line 1
# comment line 2
# comment line 3
多行字符串
description: |
hello
world
↓ 等效的 JSON
{"description": "hello\nworld\n"}
继承
parent: &defaults
a: 2
b: 3
child:
<<: *defaults
b: 4
↓ 等效的 JSON
{
"parent": {
"a": 2,
"b": 3
},
"child": {
"a": 2,
"b": 4
}
}
参考
values: &ref
- Will be
- reused below
other_values:
i_am_ref: *ref
↓ 等效的 JSON
{
"values": [
"Will be",
"reused below"
],
"other_values": {
"i_am_ref": [
"Will be",
"reused below"
]
}
}
折叠的字符串
description: >
hello
world
↓ 等效的 JSON
{"description": "hello world\n"}
两份文件
---
document: this is doc 1
---
document: this is doc 2
YAML利用---将指令与文档内容分开。
YAML Collections
序列
- Mark McGwire
- Sammy Sosa
- Ken Griffey
↓ 等效的 JSON
[
"Mark McGwire",
"Sammy Sosa",
"Ken Griffey"
]
映射
hr:65 # Home runs
avg: 0.278 # Batting average
rbi: 147 # Runs Batted In
↓ 等效的 JSON
{
"hr": 65,
"avg": 0.278,
"rbi": 147
}
映射到序列
attributes:
- a1
- a2
methods:
↓ 等效的 JSON
{
"attributes": ["a1", "a2"],
"methods": ["getter", "setter"]
}
映射序列
children:
- name: Jimmy Smith
age: 15
- name: Jimmy Smith
age: 15
-
name: Sammy Sosa
age: 12
↓ 等效的 JSON
{
"children": [
{"name": "Jimmy Smith", "age": 15},
{"name": "Jimmy Smith", "age": 15},
{"name": "Sammy Sosa", "age": 12}
]
}
序列的序列
my_sequences:
-
-
-
- 7
- 8
- 9
- 0
↓ 等效的 JSON
{
"my_sequences": [
,
,
]
}
映射的映射
Mark McGwire: {hr: 65, avg: 0.278}
Sammy Sosa: {
hr: 63,
avg: 0.288
}
↓ 等效的 JSON
{
"Mark McGwire": {
"hr": 65,
"avg": 0.278
},
"Sammy Sosa": {
"hr": 63,
"avg": 0.288
}
}
嵌套集合
Jack:
id: 1
name: Franc
salary: 25000
hobby:
- a
- b
location: {country: "A", city: "A-A"}
↓ 等效的 JSON
{
"Jack": {
"id": 1,
"name": "Franc",
"salary": 25000,
"hobby": ["a", "b"],
"location": {
"country": "A", "city": "A-A"
}
}
}
无序集
set1: !!set
? one
? two
set2: !!set {'one', "two"}
↓ 等效的 JSON
{
"set1": {"one": null, "two": null},
"set2": {"one": null, "two": null}
}
集合表现为一个映射，此中每个键都与一个空值相关联
有序映射
ordered: !!omap
- Mark McGwire: 65
- Sammy Sosa: 63
- Ken Griffy: 58
↓ 等效的 JSON
{
"ordered": [
{"Mark McGwire": 65},
{"Sammy Sosa": 63},
{"Ken Griffy": 58}
]
}
YAML 参考
条款
[*]序列又名数组或列表
[*]标量又名字符串或数字
[*]映射又名哈希或字典
基于 YAML.org refcard。
文档指标
:-:-%指令指标---文档标题...文档闭幕者 网络指标
:-:-?关键指标:代价指标-嵌套系列条目指示器,单独的内联分支条目[]围绕串联系列分支{}围绕在线键控分支 别名指标
:-:-&锚属性*别名指示符 特殊键
:-:-=默认“值”映射键<<合并来自另一个映射的键 标量指标
:-:-''围绕内联未转义标量"围绕内嵌转义标量``>折叠标量指示器-剥离 chomp 修饰符（|- 或 >-）+保留 chomp 修饰符（|+ 或 >+）1-9显式缩进修饰符（|1 或 >2）。
修饰符可以组合（|2-, >+1） 标签属性（通常未指定）
:-:-none未指定的标签（由应用步伐主动解析）!非特定标签（默认环境下，!!map/!!seq/!!str）!foo主要（按照惯例，表现本地 !foo 标志）!!foo次要的（按照惯例，表现 tag:yaml.org,2002:foo）!h!foo须要 %TAG !h! <prefix>（然后表现 <prefix>foo）!<foo>逐字标志（始终表现“foo”）杂项指标
#一次性评论指示器`@两者都保留供将来利用 核心类型（默认主动标签）
!!map{Hash table, dictionary, mapping}!!seq{List, array, tuple, vector, sequence}!!strUnicode 字符串 转义码
Numeric
[*]\x12 (8-bit)
[*]\u1234 (16-bit)
[*]\U00102030 (32-bit)
Protective
[*]\\ (\)
[*]\" (")
[*]\ ( )
[*]\<TAB> (TAB)
C
[*]\0 (NUL)
[*]\a (BEL)
[*]\b (BS)
[*]\f (FF)
[*]\n (LF)
[*]\r (CR)
[*]\t (TAB)
[*]\v (VTAB)
额外的
[*]\e (ESC)
[*]\_ (NBSP)
[*]\N (NEL)
[*]\L (LS)
[*]\P (PS)
更多类型
!!set{cherries, plums, apples}!!omap 与语言无关的标量类型
{~, null}空（无值）。[十进制整数、十六进制整数、八进制整数][固定浮点数，指数浮点数][.inf, -.Inf, .NAN][无穷大（浮点数），负数，不是数字]{Y, true, Yes, ON}布尔真{n, FALSE, No, off}布尔假
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。
页:
[1]