YAML 是一个可读性高，用来表达资料序列化的格式。
简介
- YAML（/ˈjæməl/） 是一个可读性高，用来表达资料序列化的格式。
- YAML的语法和其他高阶语言类似，并且可以简单表达清单、散列表，纯量等数据格式。
- 文件扩展名为
.yaml,.yml - 官方网站：http://yaml.org/
语言优点
- YAML易于人们阅读。
- YAML数据在编程语言之间是可移植的。
- YAML匹配敏捷语言的本机数据结构。
- YAML具有一致的模型来支持通用工具。
- YAML支持单程处理。
- YAML具有表现力和可扩展性。
- YAML易于实现和使用。
发行版本
版本 | 发布日期 |
|---|---|
YAML 1.0 | 29 January 2004 |
YAML 1.1 | 18 January 2005 |
YAML 1.2.0 | 21 July 2009 |
YAML 1.2.1 | 1 October 2009 |
YAML 1.2.2 | 1 October 2021 |
示例文件
- 数据可以用类似大纲的缩进排序方式呈现，和
Python的缩进要求很相似
---
receipt: Oz-Ware Purchase Invoice
date: 2012-08-06
customer:
given: Dorothy
family: Gale
items:
- part_no: A4786
descrip: Water Bucket (Filled)
price: 1.47
quantity: 4
- part_no: E1628
descrip: High Heeled "Ruby" Slippers
size: 8
price: 133.7
quantity: 1
bill-to: &id001
street: |
123 Tornado Alley
Suite 16
city: East Centerville
state: KS
ship-to: *id001
specialDelivery: >
Follow the Yellow Brick
Road to the Emerald City.
Pay no attention to the
man behind the curtain.
...
核心语法
- **分层：**使用空格
Space缩进表示分层，不同层次之间的缩进可以使用不同的空格数目，但是同层元素一定左对齐，即前面空格数目相同（不能使用 Tab，各个系统 Tab对应的 Space 数目可能不同，导致层次混乱） - 注释：
#表示注释，只能单行注释，从#开始处到行尾 - 列表： 破折号后面跟一个空格（a dash and space）表示列表
- **键值对：**用冒号和空格表示键值对
key: value - 数据： 简单数据（scalars，标量数据）可以不使用引号括起来，包括字符串数据。用单引号或者双引号括起来的被当作字符串数据，在单引号或双引号中使用C风格的转义字符
- 大小写敏感
基本用法
缩进
- 以空格的缩进来控制层级关系；只要是左对齐的一列数据，都是同一个层级的：
server:
port: 8081
path: /hello
属性和值大小写敏感。
字符串
如果字符串没有空格或特殊字符，不用加引号包裹
加了双引号表示引号内的字符串不会被转义 （n 为换行符）
name: “zhangsan n lisi”：输出；zhangsan 换行 lisi
加了单引号会转义特殊字符，特殊字符最终只是一个普通的字符串数据
代码语言：javascript复制1
name: ‘zhangsan n lisi’：输出；zhangsan n lisi对象
key: value， 在下一行来写对象的属性和值的关系；注意缩进m, 对象还是k: v的方式
friends:
lastName: zhangsan
age: 20
数组
- 用
-（这里有个空格）值表示数组中的一个元素
pets:
- cat
- dog
- pig
数组也可以有行内写法：
代码语言：javascript复制pets: [cat,dog,pig]
按照这个规则，数组是可以嵌套的
代码语言：javascript复制age: 23
items:
- age: 15
name: AA
sub_items:
- link: baidu
name: test
- link: google
name: foo
- age: 66
name: BB
sub_items:
- link: opencv
name: bar
- link: halcon
name: tt
数据类型
yaml 中有以下基本类型：
- 字符串
- 整型
- 浮点型
- 布尔型
- null
- 时间
- 日期
示例：
代码语言：javascript复制str: "Hello World!"
int: 110
float: 3.141
boolean: true # or false
None: null # 也可以用 ~ 号来表示 null
time: 2016-09-22t11:43:30.20 08:00 # ISO8601，写法百度
date: 2016-09-22 # 同样ISO8601
引用
& 和 * 用于引用
代码语言：javascript复制name: &name 灰蓝
tester: *name
这个相当于以下脚本：
代码语言：javascript复制name: 灰蓝
tester: 灰蓝
强制转换
- yaml 是可以进行强制转换的，用
!!实现，如下：
str: !!str 3.14
int: !!int "123"
输出：
代码语言：javascript复制{'int': 123, 'str': '3.14'}
明显能够看出123被强转成了int类型，而float型的3.14则被强转成了str型。
分段
在同一个yaml文件中，可以用 — 来分段，这样可以将多个文档写在一个文件中
代码语言：javascript复制---
name: James
age: 20
---
name: Lily
age: 19
Python 读写
- Python 可以方便地读写 yaml 文件
- 引入库
import yaml - 读 yml
yaml.load(f) - 写 yml
yaml.dump(new_date, f) - 示例代码：
import yaml
new_date = {
"name": "Tom",
"age": 23,
"sex": "man",
'items':[
{
'name': 'AA',
'age': 15,
'sub_items': [
{
'name': 'test',
'link': 'baidu'
},
{
'name': 'foo',
'link': 'google'
}
]
},
{
'name': 'BB',
'age': 66,
'sub_items': [
{
'name': 'bar',
'link': 'opencv'
},
{
'name': 'tt',
'link': 'halcon'
}
]
}
]
}
f = open("test.yaml", "w")
yaml.dump(new_date, f)
f.close()
f = open("test.yaml", "r")
loaded_yml_obj = yaml.load(f)
f.close()
print(loaded_yml_obj)
- 写下的文件：
age: 23
items:
- age: 15
name: AA
sub_items:
- link: baidu
name: test
- link: google
name: foo
- age: 66
name: BB
sub_items:
- link: opencv
name: bar
- link: halcon
name: tt
name: Tom
sex: man
- python 输出
{'age': 23, 'items': [{'age': 15, 'name': 'AA', 'sub_items': [{'link': 'baidu', 'name': 'test'}, {'link': 'google', 'name': 'foo'}]}, {'age': 66, 'name': 'BB', 'sub_items': [{'link': 'opencv', 'name': 'bar'}, {'link': 'halcon', 'name': 'tt'}]}], 'name': 'Tom', 'sex': 'man'}
参考资料
- http://yaml.org/
- https://zh.wikipedia.org/wiki/YAML
- https://zhuanlan.zhihu.com/p/493137181
文章链接： https://cloud.tencent.com/developer/article/2345866
