YAML简介
2019-09-29 本文已影响0人
光明自在
YAML是”YAML Ain't markup language"（YAML不是一种标记语言）的缩写，是一种对人类设计友好（方便读写）的数据序列化语言，可以很好地与其它编程语言协同完成日常任务。
它是JSON的一个严格超集，在语法上增加了类似Python的换行和缩进。不过，与Python不同，YAML不允许使用Tab缩进。
基本规则
YAML有一些基本的规则，用来避免与各种编程语言和编辑器相关的歧义问题，这些基本的规则使得无论哪个应用程序或软件库都能一致地解析YAML。
- 文件名以
.yaml结尾 - 大小写敏感
- 不允许使用Tab。由于Tab的支持性不够普通，因此使用空格。
基本数据类型
YAML的基本数据类型与JSON一致，字符串、数字等标量类型，List、Map等容器类型。
YAML擅长处理映射表(哈希表 / 字典)、序列(数组 / 列表)和标量(字符串 / 数字)。
标量
最基础的数据类型，包括布尔值、数字、字符串。
integer: 25
string: "25"
float: 25.0
boolean: Yes
序列
列表或者数组。每个item一行，以-开头。
- Cat
- Dog
- Goldfish
同一层级的item是一个序列，可以用缩进来表示多层的序列。
-
- Cat
- Dog
- Goldfish
-
- Python
- Lion
- Tiger
可以是多层的：
-
-
- Cat
- Dog
- Goldfish
也可以这么写：
--- Cat
- Dog
- Goldfish
映射表
键值对，如：
animal: pets
如果值是一个序列：
pets:
- Cat
- Dog
- Goldfish
5分钟教程
--- # 文档开头
# YAML注释类似这样
################
# 标量类型 #
################
# 根对象是一个map，相当于其它语言中的dictionary、hash或者object。
key: value
another_key: Another value goes here.
a_number_value: 100
scientific_notation: 1e+12
# 数字1会被解析为数值类型，而不是布尔类型。如果希望被解析为布尔类型，请使用`true`
boolean: true
null_value: null
key with spaces: value
# 字符串不需要使用引号，不过可以使用。
however: 'A string, enclosed in quotes.'
'Keys can be quoted too.': "Useful if you want to put a ':' in your key."
single quotes: 'have ''one'' escape pattern'
double quotes: "have many: \", \0, \t, \u263A, \x0d\x0a == \r\n, and more."
# UTF-8/16/32的字符需要编码
Superscript two: \u00B2
# 多行字符串可以写作"literal block"（用'|'）或者"folded block"（用'>'）
literal_block: |
整块文本都是'literal_block'的值，换行会被保留。
只要缩进的文本都包含在block中，首缩进会被去除。
多余的缩进会被保留 - 此行文字会缩进4个空格。
folded_style: >
整块文本都是`folded_style`的值，不过所有的换行会被替换为一个。
上面的空行会被转换为一个换行符。
多余的缩进依然会保留其换行 -
此段文字会展示为两行。
####################
# 容器类型 #
####################
# 嵌套使用缩进。推荐使用2个空格的缩进（但不是必须的）。
a_nested_map:
key: value
another_key: Another Value
another_nested_map:
hello: hello
# Map的key可以是非字符串
0.25: a float key
# Key可以是复杂对象，像多行对象一样，我们使用问号后跟一个空格来表示复杂Key的开始。
? |
This is a key
that has multiple lines
: and this is its value
# YAML还允许使用复杂Key语法在序列之间进行映射
# 某些语言的解析器可能会有警告
? - Manchester United
- Real Madrid
: [2001-01-01, 2002-02-02]
# 序列（List、Array等）这样表示
# (注意，'-'算作缩进)
a_sequence:
- Item 1
- Item 2
- 0.5 # 序列可以包含不同的类型
- Item 4
- key: value
another_key: another_value
-
- This is a sequence
- inside another sequence
- - - Nested sequence indicators
- can be collapsed
# YAML是JSON的严格超集，因此可以使用JSON风格的map和序列
json_map: {"key": "value"}
json_seq: [3, 2, 1, "takeoff"]
and quotes are optional: {key: [3, 2, 1, takeoff]}
#######################
# YAML的额外特性 #
#######################
# YAML有一个方便特性“anchor"，可以方便地在文档中重复内容。以下两个key对应的值相同：
anchored_content: &anchor_name This string will appear as the value of two keys.
other_anchor: *anchor_name
# Anchor可以用来重复/继承属性
base: &base
name: Everyone has same name
# 正则表达式 << 称作Merge Key Language-Independent Type，
# 表示将一个或多个map的所有key插入到当前map
foo: &foo
<<: *base
age: 10
bar: &bar
<<: *base
age: 20
# foo和bar都会包含name: Everyone has same name
# YAML还支持tag，用来显式地声明类型。
explicit_string: !!str 0.5 # 指明字符串类型
# 某些解析器实现了语言相关的tag，比如Python的复杂数值类型
python_complex_number: !!python/complex 1+2j
# 语言相关的tag可以与复杂key一起使用
? !!python/tuple [5, 7]
: Fifty Seven
# 在Python中值为{(5, 7): 'Fifty Seven'}
####################
# YAML的额外类型 #
####################
# YAML不仅可以理解字符串和数字这样的基本类型，
# 也可以理解ISO格式的日期和时间字面量。
datetime: 2001-12-15T02:59:43.1Z
datetime_with_spaces: 2001-12-14 21:59:43.10 -5
date: 2002-12-14
# !!binary这个tag表示一个base64编码的二进制对象
gif_file: !!binary |
R0lGODlhDAAMAIQAAP//9/X17unp5WZmZgAAAOfn515eXvPz7Y6OjuDg4J+fn5
OTk6enp56enmlpaWNjY6Ojo4SEhP/++f/++f/++f/++f/++f/++f/++f/++f/+
+f/++f/++f/++f/++f/++SH+Dk1hZGUgd2l0aCBHSU1QACwAAAAADAAMAAAFLC
AgjoEwnuNAFOhpEMTRiggcz4BNJHrv/zCFcLiwMWYNG84BwwEeECcgggoBADs=
# YAML也支持集合类型：
set:
? item1
? item2
? item3
or: {item1, item2, item3}
# 集合其实是值为null的map；上面的写法等同于：
set2:
item1: null
item2: null
item3: null
... # 文档结尾
