何谓 "YAML"

YAML 是一种简洁的非标记语言。YAML以数据为中心，使用空白，缩进，分行组织数据，从而使得表示更加简洁易读.

在线验证YAML语法网站

基本规则

1. 大小写敏感
2. 使用缩进表示层级关系
3. 禁止使用tab缩进，只能使用空格键
4. 缩进长度没有限制，只要元素对齐就表示这些元素属于一个层级
5. 使用#表示注释
6. 字符串可以不用引号标注

三种数据结构

map 散列表

使用冒号: 表示键值对，同一缩进的所有键值对属于一个map

# YAML表示
age:12
name:huang
#对应json表示
{'age':12,'name':'huang'}
# 也可以 将一个map写在一行:
{age:12, name:huang}

list 数组

使用连字符(-)表示：

- a
- b
- 12
# 一行表示
[a,b,c]
# 对应json表示
['a','b',12]

scalar 纯量

数据最小的单位， 不可以再分割

以下类型都属于javascript的纯量

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

# 布尔值用true和false表示
isSet: true
# null 用~表示
parent：~
# YAML 允许使用两个感叹号，强制转换数据类型。
e: !!str 123
f: !!str true
# 字符串可以写成多行，从第二行开始，必须有一个单空格缩进。换行符会被转为空格。
str: 这是一段
  多行
  字符串
# 多行字符串可以使用|保留换行符，也可以使用>折叠换行。
this: |
 Foo
 Bar
that: >
 Foo
 Bar
 
# `+` 表示保留文字块末尾的换行,`-`表示保留文字块末尾的换行
s1: |
 Foo
s2: |+
 Foo
s3: |-
 Foo
 
 # 锚点&和别名*，可以拿来引用
 # &用来建立锚点（defaults），<<表示合并到当前数据，*用来引用锚点
 defaults: &defaults
  adapter: postgres
  host: localhost
 development:
  database: myapp_development
  <<: *defaults
 test:
  database: myapp_test
  <<: *defaults

数据机构嵌套

map和list的元素可以是另一个map或者list或者是纯量。由此出现4种常见的数据嵌套：

map嵌套map

Yaml表示
websites:
    YAML: yaml.org
    Ruby: ruby-lang.org
    Python: python.org
    Perl: use.perl.org
 # 对应json表示
 { websites: 
   { YAML: 'yaml.org',
     Ruby: 'ruby-lang.org',
     Python: 'python.org',
     Perl: 'use.perl.org' } }

map嵌套list

# Yaml
languages:
  - Ruby
  - Perl
  - C
  - Python
 # 对应Json
 {languages: ['Ruby','Perl','C','Python']}

list嵌套list

# YAML表示
-
  - Ruby
  - Perl
  - Python
- 
  - C
  - C++
  - Java
# 对应json
[['Ruby', 'Perl', 'Python' ], [ 'c', 'c++', 'java' ]]

除此外，还有如下两种方法表示该结构

# 方法2
- - Ruby
  - Perl
  - Python
- - C
  - C++
  - Java
# 方法3
- [Ruby,Perl,Python]
- [C,C++,Java]

list嵌套map

# YAML表示
-
  id:1
  name: huang
-
  id:2
  name: liao
# 对应json
[{id: 1, name: 'huang'}, {id:2,name:'liao'}]

原文链接

阮大大的网站