前言
- 本篇来学习下YAML的基本用法
YAML简介
- YAML 是 “YAML Ain’t a Markup Language”(YAML 不是一种标记语言)的递归缩写。YAML 的语法和其他高级语言类似,并且可以简单表达清单、散列表,标量等数据形态。它使用空白符号缩进和大量依赖外观的特色,特别适合用来表达或编辑数据结构、各种配置文件。
YAML语法
- 大小写敏感
- 使用缩进表示层级关系
- 缩进不允许使用tab,只允许空格
- 缩进的空格数不重要,只要相同层级的元素左对齐即可
- '#'表示注释
YAML常用写法
- YAML转JSON网站:https://www.json2yaml.com/convert-yaml-to-json
- YAML支持三种数据结构
- 对象:键值对的集合,又称为映射(mapping)/ 哈希(hashes) / 字典(dictionary)
- 数组:一组按次序排列的值,又称为序列(sequence) / 列表(list)
- 纯量(scalars):单个的、不可再分的值
对象写法
- 对象键值对使用冒号结构表示 key: value,冒号后面要加一个空格,且不可省略。YAML 为对象提供了 2 种写法:
- 普通写法:用缩进表示对象与属性的层级关系
info: name: 大海 age: 28 city: 北京
2. 行内写法
info: {name: 大海, age: 28, city: 北京}
3. 较为复杂的对象格式,可以使用问号加一个空格代表一个复杂的 key,配合一个冒号加一个空格代表一个 value:
? - key1 - key2 : - value1 - value2
数组写法
- YAML 使用 “-” 表示数组中的元素,也有两种写法:
- 普通写法
cityList: - 北京 - 上海 - 大连
- 行内写法
cityList: [ 北京,上海,大连 ]
纯量写法
- 纯量又称字面量,是指单个的,不可拆分的值,例如:数字、字符串、布尔值、以及日期等
- 字符串
str: - '你 好' # 可以使用双引号或者单引号包裹特殊字符 - Hello World # 字符串可以拆成多行,每一行会被转化成一个空格 - '测试 \n 开发' # 若字符串使用单引号,则会转义特殊字符 - "测试 \n 开发" # 若字符串使用双引号,则不会转义特殊字符,特殊字符会输出为其本身想表达的含义
2. 布尔值
boolean: - TRUE # true,True 都可以 - false # false,False 都可以
3. 整数
int: - 666 - 0b1010_0111_0100_1010_1110 #二进制表示
4. 浮点数
float: - 3.14 - 6.8523015e+5 # 可以使用科学计数法
- Null
k8s: nodeName: 'node' parent: ~ # 使用~表示null
- 时间
date: - 2018-02-17 # 日期必须使用ISO 8601格式,即yyyy-MM-dd
- 日期
datetime: - 2018-02-17T15:02:31+08:00 # 时间使用ISO 8601格式,时间和日期之间使用T连接,最后使用+代表时区
YAML类型强转
- 使用两个感叹号,强制转换数据类型
str: !!str 666 PI: !!float '3.14' age: !!int '28'
YAML复合结构
- 以上三种数据结构可以随意组合使用组成复合结构,例:
languages: - Ruby - Perl - Python websites: YAML: yaml.org Ruby: ruby-lang.org Python: python.org Perl: use.perl.org
YMAL引用
- 当 YAML 文件中出现多个重复内容时,可以通过 锚点& 与 引用* 实现引用锚点处内容的功能,从而在修改时,只需要修改锚点处的内容,即可在所有引用处生效。
符号 | 作用 |
& | 用来建立锚点(defaults) |
<< | 表示合并到当前数据 |
* | 用来引用锚点 |
- & 锚点和 * 别名,可以用来引用
defaults: &defaults host: 192.168.1.111 port: 6379 dev: database: dev_db <<: *defaults prod: database: prod_db <<: *defaults
相当于
defaults: host: 192.168.1.111 port: 6379 dev: database: dev_db host: 192.168.1.111 port: 6379 prod: database: prod_db host: 192.168.1.111 port: 6379
- 直接在键后设置锚点,然后空格设置值,这样在引用时,只引用值。
defaults: host: &host 192.168.1.111 port: &port 6379 dev: database: dev_db host: *host port: *port prod: database: prod_db host: *host port: *port