YAML 语言

YAML 是专门用来写配置文件的语言,非常简洁和强大,远比 JSON 格式方便。

基本语法规则如下。
  • 大小写敏感
  • 使用缩进表示层级关系
  • 缩进时不允许使用Tab键,允许使用空格。
  • 缩进的空格数目不重要,只要相同层级的元素左侧对齐即可
# 表示注释,从这个字符一直到行尾,都会被解析器忽略。

YAML 支持的数据结构有三种。

  • 对象:键值对的集合,又称为映射(mapping)/ 哈希(hashes) / 字典(dictionary)
  • 数组:一组按次序排列的值,又称为序列(sequence) / 列表(list) // 一条连线+空格开头的行
  • 纯量(scalars):单个的、不可再分的值
数组和对象也可以使用行内表达式,类似js
纯量:
  • 字符串 // 特殊字符需使用引号,单引号和双引号都可以使用,双引号不会对特殊字符转义。
    多行字符串可以使用|保留换行符,也可以使用>折叠换行, 使用缩进时换行转为空格
    表示保留文字块末尾的换行,-表示删除字符串末尾的换行
  • 布尔值
  • 整数
  • 浮点数
  • Null // 使用 ~ 表示
  • 时间 // 时间采用 ISO8601 格式, 2001-12-14t21:59:43.10-05:00
  • 日期 // 2001-12-14

YAML 允许使用两个感叹号,强制转换数据类型。 // !!str true

锚点&和别名*,可以用来引用,如:
defaults: &defaults
  adapter:  postgres
  host:     localhost

development:
  database: myapp_development
  <<: *defaults # << 表示合并到当前数据

test:
  database: myapp_test
  <<: *defaults