简介

YAML[ Yet Another Markup Language ]英译过来，就是“另一门标志语言”。它是一种直观的，容易被人类阅读，以及被机器识别的数据格式。

它类似于XML和，但语法上，要比前者简洁很多。

具体感受一下，一个简单的 yml 文件:

Author:
  name: da宗熊
  age: 还年轻

通过解析器生成后，最终得到数据 :

{
  Author: {
    name: "da宗熊",age : "还年轻" } }

格式

YAML文件，可以存储 map 或 array 对象。

map和array定义

map通过缩进来表示，其中的 key/map对，用 “:” 进行间隔。array通过减少”-“来表示。“#”代表注释。如下例子:

# 这一行注释，是不会输出的
Author:
  name: da宗熊 # 这也是注释，不会输出的
  desc:
    - 帅气     - 阳光     - 很好看

将得出数据:

{
  Author: {
    name: "da宗熊",desc: ["帅气","阳光","很好看"] } }

map对象，也可以使用json方式定义:

Author: {name: da宗熊,age: 未知}

PS: JSON的语法是YAML1.2版的子集，同时非常接近YAML1.0与1.1版的子集，因此大部分的JSON文件都可以被YAML的剖析器剖析

同样的，array对象，也可以类似的定义:

List1: [a,b,c]
# 与下面定义等价
List2:
  - a   - b   - c

空值

YAML有几种空值的表现方式，分别是 “null”、”~” 和 不填。

text1: null
text2: ~
text3: 

最后得出数据:

{text1: null,text2: null,text3: null}

字符串

字符串如果涉及到换行，可以使用 “|” 或 “>” 作为前缀标志。”|”表示下面的内容，换行; “>”表示，下面内容中，所有的换行，变为空格。

text1: |
  一段文字
  第二段文字
text2: >
  一段文字
  第二段文字

将得到:

{
  text1: "一段文字↵第二段文字",text2: "一段文字 第二段文字" }

合并

可指定特定的数据，与数组中当前的数据进行合并:

merge:
  # 声明两个可引用的数据，这两个数据，也会输出
  - &CENTER {x: 1,y: 1}
  - &LEFT {x: 0,y: 1}
  - # 定义对象1
    <<: *CENTER
    label: 引入CENTER数据，与当前数据合并
  - # 定义对象2
    <<: [*CENTER,*LEFT] 
    label: 可引入多个数据
  - # 定义对象3
    center: *CENTER
    left:   *LEFT
    label:  也可以纯粹的引入，而不合并

将会输出:

{
  "merge": [ { "x": 1,"y": 1 },{ "x": 0,{ "x": 1,"y": 1,"label": "引入CENTER数据，与当前数据合并" },"label": "可引入多个数据" },{ "center": { "x": 1,"y": 1 },"left": { "x": 0,"label": "也可以纯粹的引入，而不合并" } ] }

最后

更多语法，可参考 这里