YAML入门教程

1.简介

YAML 是 “Yet Another Markup Language” 的缩写（仍然是一种标记语言）。

YAML的配置文件 后缀为 .yml ，如 : runob.yml。

2.基本语法

• 大小写敏感
• 使用缩进表示层级关系
• 缩进不允许使用 tab , 只允空格
• 缩进空格数不重要 ，只要相同层级的元素左对齐即可
• '#' 表示注释

3.数据类型

YAML支持以下几种数据类型

• 对象 : 键值对集合，又称为映射 / 哈希 / 字典
• 数组 ： 一组按次序排列的值 ， 又称为序列/列表
• 纯量 : 单个的，不可再分的值

3.1 YAML对象

对象键值对使用冒号结构表示key: value ,冒号后面要加一个空格。

也可以使用key:{key1: value1,key2: value2,…}。

还可以使用缩进表示层级关系

key: 
     child-key1: value1
     child-key2: value2

3.2 YAML数组

以- 开头的行表示构成一个数组：

-A
-B
-C

YAML支持多维数组，可以使用行内表示：

key: [value1,value2]

数据结构的子成员是一个数组，则可以在该项下面缩进一个空格。

-
   -A
   -B
   -C

一个相对复杂的例子 :

user:
  -
      id: 1
      name: 张三
      price: 200
      
  -
      id: 2
      name: 李四  #  : 后面有个空格
      price: 100

意思是 user 属性是一个数组，每一个数组元素又是由 id , name , price 三个属性构成。

3.2.2 复合结构

数组和对象可以构成复合结构，例：

languages:
	- Ruby
	- Perl
	- Python
websites:
    YAML: yaml.org
    Ruby: ruby-lang.org
	

转换为 json 为

{
    languages: [ 'Ruby', 'Perl', 'Python'],
  websites: {
    YAML: 'yaml.org',
    Ruby: 'ruby-lang.org',
    Python: 'python.org',
    Perl: 'use.perl.org' 
  } 
}

3.3 纯量

纯量是最基本的，不可再分的值，包括：

• 字符串
• 布尔值
• 整数
• 浮点数
• Null
• 时间
• 日期

例：

boolean:
	- True
	- False
float:
	-3.14
int:
	- 12
null:
	nodeName: 'node'
	parent: ~ #使用~表示null
string:
	- 哈哈
	- 'Hello World' #可以使用双引号或者单引号包裹特殊字符
date:
	- 2018-01-01 #日期必须使用ISO 8601格式，即yyyy-MM-dd
datetime:
	- 2018-01-01T15:02:31+08:00 #日期必须使用ISO 8601格式，时间和日期之间使用T连接，最后使用+代表时区
	

4.引用

defaults: &defaults
	username: root
	password: localhost

development:
	database: 127.0.0.1
	<<: *defaults
	
test:
	database: 22.5.235.1
	<<: *defaults

& 用来建立锚点（defaults）, << 表示合并到当前数据，* 用来引用锚点。

相当于

defaults:
  username: root
  password: localhost

development:
  database: myapp_development
  username: root
  password: localhost

test:
  database: myapp_test
  username: root
  password: localhost

• 还有${变量名称}和%变量名称%可能是相同的原理吧？