官网:https://yaml.org/

YAML(Yet another Markup Language,仍是一种标记语言)是一个可读性高的用来表达资料序列的格式。

目前很多软件采用了此格式,如ansible、docker、k8s等。

语法说明

  • YAML 的配置文件后缀为.yml
  • 大小写敏感
  • 使用缩进表示层级关系
  • 缩进不允许使用tab,只允许空格
  • 缩进的空格数不重要,只要相同层级的元素左对齐即可
  • #表示注释,从这个字符一直到行尾,都会被解析器忽略

数据结构

YAML 支持的数据结构有三种。

  • 对象:键值对的集合,又称为映射(mapping)/ 哈希(hashes) / 字典(dictionary)
  • 数组:一组按次序排列的值,又称为序列(sequence) / 列表(list)
  • 纯量(scalars):单个的、不可再分的值

对象

对象的一组键值对,使用冒号:结构表示。例如:

1
name: 'Rohn'

Yaml 也允许另一种写法,将所有键值对写成一个行内对象。例如:

1
{ hash: { name: 'Steve', foo: 'bar' } }

数组

一组连词线-开头的行,构成一个数组。例如:

1
2
3
- Cat
- Dog
- Goldfish

纯量

纯量是最基本的、不可再分的值。

纯量的类型:

  • 字符串
  • 布尔值
  • 整数
  • 浮点数
  • Null
  • 时间
  • 日期
字符串
  • 字符串默认不使用引号表示。
  • 如果字符串之中包含空格或特殊字符,需要放在引号之中。
  • 单引号和双引号都可以使用,双引号不会对特殊字符转义。
  • 单引号之中如果还有单引号,必须连续使用两个单引号转义。
  • 字符串可以写成多行,从第二行开始,必须有一个单空格缩进。换行符会被转为空格。
  • 多行字符串可以使用|保留换行符,也可以使用>折叠换行。
  • +表示保留文字块末尾的换行,-表示删除字符串末尾的换行。
  • 字符串之中可以插入 HTML 标记。