YAML 语言
YAML 是专门用来写配置文件的语言,非常简洁和强大,远比 JSON 格式方便。
基本语法规则如下。
- 大小写敏感
- 使用缩进表示层级关系
- 缩进时不允许使用Tab键,只允许使用空格。
- 缩进的空格数目不重要,只要相同层级的元素左侧对齐即可
#
表示注释,从这个字符一直到行尾,都会被解析器忽略。YAML 支持的数据结构有三种。
数组和对象也可以使用行内表达式,类似js
- 对象:键值对的集合,又称为映射(mapping)/ 哈希(hashes) / 字典(dictionary)
- 数组:一组按次序排列的值,又称为序列(sequence) / 列表(list) // 一条连线+空格开头的行
- 纯量(scalars):单个的、不可再分的值
纯量:
- 字符串 // 特殊字符需使用引号,单引号和双引号都可以使用,双引号不会对特殊字符转义。
多行字符串可以使用|
保留换行符,也可以使用>
折叠换行, 使用缩进时换行转为空格表示保留文字块末尾的换行,
-
表示删除字符串末尾的换行- 布尔值
- 整数
- 浮点数
- 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