基础

假如你想更进一步，请继续阅读。

数据类型

对象

键值对的集合。

形如 key: value ， 也可以形如 key1: {key1: value1, key2: value2, ...} 。

比如这里 key 是键， value 是这个键的值 :(冒号后有个空格)被称为 映射标记 。

数组

以 - 开头的行表示构成一个数组，数组是一组按次序排列的值。

YAML 支持多维数组，可以使用行内表示：key: [value1, value2, ...] 。

这个写法相当于：

key1:
  - value1
  - value2
  - ...

一个相对复杂的例子：

companies:
    - id: 1
      name: company1
      price: 200W
    - id: 2
      name: company2
      price: 500W

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

复合结构

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

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

转换为 JSON 为：

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

纯量

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

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

例子：

boolean:
    - TRUE  # true， True 都可以。
    - FALSE  # false， False 都可以。
float:
    - 3.14
    - 6.8523015e+5  # 可以使用科学计数法。
int:
    - 123
    - 0b1010_0111_0100_1010_1110  # 二进制表示。
null:
    nodeName: 'node'
    parent: ~  # 使用 ~ 表示 null 。
string:
    - 哈哈
    - 'Hello world'  # 可以使用双引号或者单引号包裹特殊字符。
    - newline
      newline2  # 字符串可以拆成多行，每一行会被转化成一个空格。
date:
    - 2018-02-17  # 日期必须使用 ISO 8601 格式，即 yyyy-MM-dd 。
datetime:
    -  2018-02-17T15:02:31+08:00  # 时间和日期之间使用 T 连接， 最后使用 + 代表时区。

缩进

书写的时候要尤其注意缩进。

如：

options:
  enable: true
  check: false
  drop-block: true
  other:
    money: 10
    welcome: "欢迎你"
guide:
  show: true
  receive: "你好"

我们称 options 和 guide 在同一缩进下。

enable 和 check 在同一缩进下，同样的，enable 和 drop-block 也在同一缩进下，以此类推。

而 options.enable (指 options 缩进下的 enable 键) 和 options.other.money 以及 guide.show 则不在同一缩进下。

在同一缩进下不允许出现相同的键，如：

options:
  enable: true
  enable: false
  check: false

如果你的文本编辑器支持 YAML 语法，那么它应该会标红提示你语法错误，这样的配置插件读取也会报错。

不在同一缩进下则可以出现相同的键，如：

options:
  enable: true
  check: false
guide:
  enable: true
  check: true