YAML配置文件

参考了 YAML官网
YAML 是专注于写配置文件的语言,这个名字的含义是 YAML Ain't Markup Language(YAML不是一种标记语言) ,但是实际上 YAML 还是一种标记语言,只不过是更加聚焦于数据的标记语言。

  • YAML的基本语法规则
  • 大小写敏感
  • 使用缩进表示层级关系(这个和Python很像了,估计是从Python借鉴的)
    缩进时绝对不允许使用Tab键,只允许使用空格键
    缩进的空格数不重要,只要元素左侧能对齐就可以。
    字符串可以不用引号标注
  • YAML完全兼容Json的语法,可以把Json看做是YAML的一个子集

    我们来看一下YAML支持的数据类型

  • 对象:就是键值对的集合,和Json中对象的概念一样
  • 列表:又称为序列,是一组有序排列的值,和Json中列表的概念一样
  • scalars(纯量):不可拆分的数据类型,和Json中的基本数据类型一样
  • 来看一下 YAML 具体的语法。

  • 在一个 yml 文件中,使用 --- 来表示一段文档(或者一组配置)的开始,使用 ... 来表示一段文档的结束。如果 yml 中只有一组配置,则可以省略掉 --- .

  • 使用 # 来表示注解

  • 使用 - 来表示单个的列表项,比如

  • 对应Json中的 [ 'A', 'B', 'C' ]

    对应于Json的 [ [ 'A', 'B', 'C' ], [ 'D', 'E', 'F' ] ]

    尤其是要注意,由于YAML兼容Json的语法,所以我们直接在yml文件中写 [ [ A, B, C ], [ D, E, F ] ] 也是可以的。

  • 使用 : 来表示键值对
  • name: chico
    age: 18
    

    对应Json的{ name: 'chico', age: 18 }

    name: chico age: 18 name: dong age: 19

    对应Json中的[ { name: 'chico', age: 18 }, { name: 'dong', age: 19 } ]

    看一个将列表和对象结合起来的

    american:
      - Boston Red Sox
      - Detroit Tigers
      - New York Yankees
    national:
      - New York Mets
      - Chicago Cubs
      - Atlanta Braves
    

    对应Json { american: [ 'Boston Red Sox', 'Detroit Tigers', 'New York Yankees' ], national: [ 'New York Mets', 'Chicago Cubs', 'Atlanta Braves-' ] }

    与Json不同的是,YAML中键值对的键不要求一定是字符串,可以是一些复杂的类型,但是Json中要求键值对的键必须是字符串。

    当YAML中键值对的键是复杂类型的时候,必须要用?说明,比如

    ?[a,b,c]:color
    :color
    
  • YAML中null~表示
    比如money:~

  • YAML中段落用|和缩进表示,YAML会保留该段落中的回车换行符

    description: |
    #注意:和 |之间的空格
      这是一篇非常非常长的介绍YAML的文章
      文章是非常有内容的
    
  • YAML中用>和缩进表示把段落连城一句话,YAML会把该段落中的回车换行替换成空格,最终连成一句话
  • description: >
      这是一篇介绍YAML的文章,非常长
      但是把他们连成一句话了
    
  • YAML中+表示保留段落末尾的换行,-表示删除文本末尾的换行
  • a: |+
      保留了换行符
    b: |-
      删除了换行符
    

    对应的json是{ hahaha: null, 'chico dong': null, 'haha lala': null }

    在YAML中ordered map就是一组有序的键值对(可以认为是放在list中的键值对),

    --- !!omap #强行转换为有序键值对
    - hahaha: haha