何谓 “YAML”
YAML 是一种简洁的非标记语言。YAML以数据为中心,使用空白,缩进,分行组织数据,从而使得表示更加简洁易读.
基本规则
- 大小写敏感
- 使用缩进表示层级关系
- 禁止使用tab缩进,只能使用空格键
- 缩进长度没有限制,只要元素对齐就表示这些元素属于一个层级
- 使用#表示注释
- 字符串可以不用引号标注
三种数据结构
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'}]