Yaml：基本语法使用
YAML介绍
YAML是”YAML Ain’t a Markup Language”（YAML不是一种置标语言）的递归缩写，早先YAML的意思其实是：”Yet Another Markup Language”（另外一种置标语言）
YAML语法
- YAML使用可打印的Unicode字符，可使用UTF-8或UTF-16
- 使用空白字符（不能使用Tab）分层，同层元素左侧对齐
- 单行注解由井字号（ # ）开始，可以出现在行中任何位置
- 每个清单成员以单行表示，并用短杠+空白（- ）起始
- 每个杂凑表的成员用冒号+空白（: ）分开键和值
- 杂凑表的键值可以用问号 (?)起始，表示多个词汇组成的键值
- 字串一般不使用引号，但必要的时候可以用引号框住
- 使用双引号表示字串时，可用倒斜线（\）进行特殊字符转义
- 区块的字串用缩排和修饰词（非必要）来和其他资料分隔，有新行保留（使用符号|）或新行折叠（使用符号>）两种方式
- 在单一档案中，可用连续三个连字号（---）区分多个档案
- 可选择性的连续三个点号（...）用来表示档案结尾(在流式传输时非常有用，不需要关闭流即可知道到达结尾处)
- 重复的内容可使从参考标记星号 (*)复制到锚点标记（&）
- 指定格式可以使用两个惊叹号 ( !! )，后面接上名称
Yaml编写规范
规范一：文档使用 Unicode 编码作为字符标准编码，例如 UTF-8
规范二：使用“#”来表示注释内容
# 客户订单
date: 2015-02-01
customer:
- name: Jai
items:
- no: 1234 # 订单号
- descript: cpu
规范三：使用空格作为嵌套缩进工具。通常建议使用两个空格缩进，不建议使用 tab （甚至不支持）
规范四：序列表示
1、使用“-”（横线） + 单个空格表示单个列表项
--- # 文档开始
- 第一章 简介
- 第二章 设计目录2、使用"[]"表示一组数据
--- # 文档开始
[blue, red, green]3、组合表示。每个结构都可以嵌套组成复杂的表示结构
--- # 文档开始
- [blue, red, green] # 列表项本身也是一个列表
- [Age, Bag]
- site: {osc:www.oschina.net, baidu: www.baidu.com} # 这里是同 键值表 组合表示
规范五：键值表
1、使用 “:”（冒号） + 空格表示单个键值对
# 客户订单
date: 2015-02-01
customer:
- name: Jai
items:
- no: 1234 # 订单号
- descript: cpu
- price: ￥800.00
2、使用"{}"表示一个键值表
# 客户订单
date: 2015-02-01
customer:
- name: Jai
items: {no: 1234, descript: cpu, price: ￥800.00}3、"? " 问号+空格表示复杂的键。当键是一个列表或键值表时，就需要使用本符号来标记
# 使用一个列表作为键
? [blue, reg, green]: Color
# 等价于
? - blue
- reg
- gree
: Color
4、组合表示。每个结构都可以嵌套组成复杂的表示结构
Color:
- blue
- red
- green
# 相当于 (也是 JSON 的表示)
{Color: [blue, red, green]}
div:
- border: {color: red, width: 2px}
- background: {color: green}
- padding: [0, 10px, 0, 10px]
# 使用缩进表示的键值表与列表项
items:
- item: cpu
model: i3
price: ￥800.00
- item: HD
model: WD
price: ￥450.00
# 上面使用 “-” 前导与缩进来表示多个列表项，相当于下面的JSON表示
items: [{item:cpu, model:i3, price:￥800.00}, {item:HD, model:WD, price: ￥450.00}]
规范六：文本块
1、使用 “|” 和文本内容缩进表示的块：保留块中已有的回车换行。相当于段落块
# 注意 ":" 与 "|" 之间的空格 yaml: | JSON的语法其实是YAML的子集，大部分的JSON文件都可以被YAML的解释器解释。 如果你想更深入的学习YAML，我建议你去 http://www.yaml.org 看看
2、使用 “>” 和文本内容缩进表示的块：将块中回车替换为空格，最终连接成一行
# 注意 ":" 与 ">" 之间的空格，另外可以使用空行来分段落 yaml: > JSON的语法其实是YAML的子集， 大部分的JSON文件都可以被YAML的解释器解释。 如果你想更深入的学习YAML，我建议你去 http://www.yaml.org 看看
3、使用定界符“”（双引号）、‘’（单引号）或回车表示的块：最终表示成一行
yaml: # 使用回车的多行，最终连接成一行。 JSON的语法其实是YAML的子集， 大部分的JSON文件都可以被YAML的解释器解释。 yaml: # 使用了双引号，双引号的好处是可以转义，即在里面可以使用特殊符号 "JSON的语法其实是YAML的子集， 大部分的JSON文件都可以被YAML的解释器解释。"
4、当数据中含有空格或任意特殊字符，需要使用引号来包裹任何包含冒号的哈希值, 像这样:
foo: "somebody said I should put a colon here: so I did" # 然后这个冒号将会被结尾.
规范七：数据类型的约定
1、对一些常用数据类型的表示格式进行了约定，包括:
integer: 12345 # 整数标准形式
octal: 0o34 # 八进制表示，第二个是字母 o
hex: 0xFF # 十六进制表示
float: 1.23e+3 # 浮点数
fixed: 13.67 # 固定小数
minmin: -.inf # 表示负无穷
notNumber: .NaN # 无效数字
null: # 空值
boolean: [true, false] # 布尔值
string: ‘12345‘ # 字符串
date: 2015-08-23 # 日期
datetime: 2015-08-23T02:02:00.1z # 日期时间
iso8601: 2015-08-23t21:59:43.10-05:00 # iso8601 日期格式
spaced: 2015-08-23 21:59:43.10 -5 # ?
2、“!”（叹号）显式指示类型，或自定义类型标识。单叹号通常是自定义类型，双叹号是内置类型，例如：
isString: !!str 2015-08-23 # 强调是字符串不是日期数据
picture: !!binary | # Base64 图片
R0lGODlhDAAMAIQAAP//9/X
17unp5WZmZgAAAOfn515eXv
Pz7Y6OjuDg4J+fn5OTk6enp
56enmleECcgggoBADs=-
#下面是内置类型 !!int # 整数类型 !!float # 浮点类型 !!bool # 布尔类型 !!str # 字符串类型 !!binary # 也是字符串类型 !!timestamp # 日期时间类型 !!null # 空值 !!set # 集合 !!omap, !!pairs # 键值列表或对象列表 !!seq # 序列，也是列表 !!map # 键值表
#下面是一些例子：
--- !!omap
- Mark: 65
- Sammy: 63
- Key: 58
--- !!set # 注意，“?”表示键为列表，在这里列表为 null
? Mark
? Sammy
? Key
# 下面是自定义的类型或标识
%TAG ! tag:clarkevans.com,2002: # % 是指令符号
--- !shape
# Use the ! handle for presenting
# tag:clarkevans.com,2002:circle
- !circle
center: &ORIGIN {x: 73, y: 129}
radius: 7
- !line
start: *ORIGIN
finish: { x: 89, y: 102 }
- !label
start: *ORIGIN
color: 0xFFEEBB
text: Pretty vector drawing.
#test.yaml（双叹号，强制转换类型）
str: !!str 3.14
int: !!int "123"
输出：{'int': 123, 'str': '3.14'} #明显能够看出123被强转成了int类型，而float型的3.14则被强转成了str型
规范八：锚点与引用，定义数据的复用。
-
第一步：使用 “&” 定义数据锚点（即要复制的数据）
-
第二步：使用 “*” 引用上述锚点数据（即数据的复制目的地）
--- hr: - Mark McGwire # Following node labeled SS - &SS Sammy Sosa # 定义要复制的数据 rbi: - *SS # Subsequent occurrence 这里是数据复制目标 - Ken Griffey
参考链接：
https://yaml.org/
https://www.cnblogs.com/yxfeng/p/10396288.html