NitWikit/docs/扩展阅读/YAML语法/基础.md

sidebar_position
2

基础

数据类型

对象

键值对的集合。

形如 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    #时间使用ISO 8601格式，时间和日期之间使用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