【YAML】一文掌握 YAML 的详细用法（YAML 备忘速查）

文章目录

- 入门
- - 介绍
  - 标量类型
  - - [↓ 等效的 JSON](#↓ 等效的 JSON)
  - 变量
  - - [↓ 等效的 JSON](#↓ 等效的 JSON)
  - 注释
  - 多行字符串
  - - [↓ 等效的 JSON](#↓ 等效的 JSON)
  - 继承
  - - [↓ 等效的 JSON](#↓ 等效的 JSON)
  - 参考
  - - [↓ 等效的 JSON](#↓ 等效的 JSON)
  - 折叠的字符串
  - - [↓ 等效的 JSON](#↓ 等效的 JSON)
  - 两份文件
- [YAML Collections](#YAML Collections)
- - 序列
  - - [↓ 等效的 JSON](#↓ 等效的 JSON)
  - 映射
  - - [↓ 等效的 JSON](#↓ 等效的 JSON)
  - 映射到序列
  - - [↓ 等效的 JSON](#↓ 等效的 JSON)
  - 映射序列
  - - [↓ 等效的 JSON](#↓ 等效的 JSON)
  - 序列的序列
  - - [↓ 等效的 JSON](#↓ 等效的 JSON)
  - 映射的映射
  - - [↓ 等效的 JSON](#↓ 等效的 JSON)
  - 嵌套集合
  - - [↓ 等效的 JSON](#↓ 等效的 JSON)
  - 无序集
  - - [↓ 等效的 JSON](#↓ 等效的 JSON)
  - 有序映射
  - - [↓ 等效的 JSON](#↓ 等效的 JSON)
- [YAML 参考](#YAML 参考)

这是理解和编写 YAML 格式配置文件的快速参考备忘单。

参考：

入门

介绍

YAML 是一种数据序列化语言，旨在供人类直接读写

YAML 不允许使用制表符
元素部分之间必须有空间
YAML 区分大小写
以 .yaml 或 .yml 扩展名结束您的 YAML 文件
YAML 是 JSON 的超集
Ansible playbook 是 YAML 文件

标量类型

yaml 复制代码

n1: 1            # 整数
n2: 1.234        # 浮点
s1: 'abc'        # 字符串
s2: "abc"        # 字符串
s3: abc          # 字符串
b: false         # 布尔类型
d: 2015-04-05    # 日期类型

↓ 等效的 JSON

json 复制代码

{
  "n1": 1,
  "n2": 1.234,
  "s1": "abc",
  "s2": "abc",
  "s3": "abc",
  "b": false,
  "d": "2015-04-05"
}

使用空格缩进。元素部分之间必须有空间。

变量

yaml 复制代码

some_thing: &VAR_NAME foobar
other_thing: *VAR_NAME

↓ 等效的 JSON

json 复制代码

{
  "some_thing": "foobar",
  "other_thing": "foobar"
}

注释

yaml 复制代码

# A single line comment example
# block level comment example
# comment line 1
# comment line 2
# comment line 3

多行字符串

yaml 复制代码

description: |
  hello
  world

↓ 等效的 JSON

json 复制代码

{"description": "hello\nworld\n"}

继承

yaml 复制代码

parent: &defaults
  a: 2
  b: 3
child:
  <<: *defaults
  b: 4

↓ 等效的 JSON

json 复制代码

{
  "parent": {
    "a": 2,
    "b": 3
  },
  "child": {
    "a": 2,
    "b": 4
  }
}

参考

yaml 复制代码

values: &ref
  - Will be
  - reused below
  
other_values:
  i_am_ref: *ref

↓ 等效的 JSON

json 复制代码

{
  "values": [
    "Will be",
    "reused below"
  ],
  "other_values": {
    "i_am_ref": [
      "Will be",
      "reused below"
    ]
  }
}

折叠的字符串

yaml 复制代码

description: >
  hello
  world

↓ 等效的 JSON

json 复制代码

{"description": "hello world\n"}

两份文件

yaml 复制代码

---
document: this is doc 1
---
document: this is doc 2

YAML使用---将指令与文档内容分开。

YAML Collections

序列

yaml 复制代码

- Mark McGwire
- Sammy Sosa
- Ken Griffey

↓ 等效的 JSON

json 复制代码

[
  "Mark McGwire",
  "Sammy Sosa",
  "Ken Griffey"
]

映射

yaml 复制代码

hr:  65       # Home runs
avg: 0.278    # Batting average
rbi: 147      # Runs Batted In

↓ 等效的 JSON

json 复制代码

{
  "hr": 65,
  "avg": 0.278,
  "rbi": 147
}

映射到序列

yaml 复制代码

attributes:
  - a1
  - a2
methods: [getter, setter]

↓ 等效的 JSON

json 复制代码

{
  "attributes": ["a1", "a2"],
  "methods": ["getter", "setter"]
}

映射序列

yaml 复制代码

children:
  - name: Jimmy Smith
    age: 15
  - name: Jimmy Smith
    age: 15
  -
    name: Sammy Sosa
    age: 12

↓ 等效的 JSON

json 复制代码

{
  "children": [
    {"name": "Jimmy Smith", "age": 15},
    {"name": "Jimmy Smith", "age": 15},
    {"name": "Sammy Sosa", "age": 12}
  ]
}

序列的序列

yaml 复制代码

my_sequences:
  - [1, 2, 3]
  - [4, 5, 6]
  -  
    - 7
    - 8
    - 9
    - 0

↓ 等效的 JSON

json 复制代码

{
  "my_sequences": [
    [1, 2, 3],
    [4, 5, 6],
    [7, 8, 9, 0]
  ]
}

映射的映射

yaml 复制代码

Mark McGwire: {hr: 65, avg: 0.278}
Sammy Sosa: {
    hr: 63,
    avg: 0.288
  }

↓ 等效的 JSON

json 复制代码

{
  "Mark McGwire": {
    "hr": 65,
    "avg": 0.278
  },
  "Sammy Sosa": {
    "hr": 63,
    "avg": 0.288
  }
}

嵌套集合

yaml 复制代码

Jack:
  id: 1
  name: Franc
  salary: 25000
  hobby:
    - a
    - b
  location: {country: "A", city: "A-A"}

↓ 等效的 JSON

json 复制代码

{
  "Jack": {
    "id": 1,
    "name": "Franc",
    "salary": 25000,
    "hobby": ["a", "b"],
    "location": {
        "country": "A", "city": "A-A"
    }
  }
}

无序集

yaml 复制代码

set1: !!set
  ? one
  ? two
set2: !!set {'one', "two"}

↓ 等效的 JSON

json 复制代码

{
  "set1": {"one": null, "two": null},
  "set2": {"one": null, "two": null}
}

集合表示为一个映射，其中每个键都与一个空值相关联

有序映射

yaml 复制代码

ordered: !!omap
- Mark McGwire: 65
- Sammy Sosa: 63
- Ken Griffy: 58

↓ 等效的 JSON

json 复制代码

{
  "ordered": [
     {"Mark McGwire": 65},
     {"Sammy Sosa": 63},
     {"Ken Griffy": 58}
  ]
}

YAML 参考

条款

序列又名数组或列表
标量又名字符串或数字
映射又名哈希或字典

基于 YAML.org refcard。

文档指标

:-	:-
`%`	指令指标
`---`	文档标题
`...`	文档终结者

收集指标

:-	:-
`?`	关键指标
`:`	价值指标
`-`	嵌套系列条目指示器
`,`	单独的内联分支条目
`[]`	环绕串联系列分支
`{}`	环绕在线键控分支

别名指标

:-	:-
`&`	锚属性
`*`	别名指示符

特殊键

:-	:-
`=`	默认"值"映射键
`<<`	合并来自另一个映射的键

标量指标

:-	:-
`''`	环绕内联未转义标量
`"`	环绕内嵌转义标量
`	`
`>`	折叠标量指示器
`-`	剥离 chomp 修饰符（`
`+`	保留 chomp 修饰符（`
`1-9`	显式缩进修饰符（`

标签属性（通常未指定）

:-	:-
`none`	未指定的标签（由应用程序自动解析）
`!`	非特定标签（默认情况下，`!!map`/`!!seq`/`!!str`）
`!foo`	主要（按照惯例，表示本地 `!foo` 标记）
`!!foo`	次要的（按照惯例，表示 `tag:yaml.org,2002:foo`）
`!h!foo`	需要 `%TAG !h! <prefix>`（然后表示 `<prefix>foo`）
`!<foo>`	逐字标记（始终表示"foo"）

杂项指标


`#`	一次性评论指示器
```@``	两者都保留供将来使用

核心类型（默认自动标签）


`!!map`	`{Hash table, dictionary, mapping}`
`!!seq`	`{List, array, tuple, vector, sequence}`
`!!str`	Unicode 字符串

转义码

Numeric

\x12 (8-bit)
\u1234 (16-bit)
\U00102030 (32-bit)

Protective

\\ (\)
\" (")
\ ( )
\<TAB> (TAB)

C

\0 (NUL)
\a (BEL)
\b (BS)
\f (FF)
\n (LF)
\r (CR)
\t (TAB)
\v (VTAB)

额外的

\e (ESC)
\_ (NBSP)
\N (NEL)
\L (LS)
\P (PS)


`!!set`	`{cherries, plums, apples}`
`!!omap`	`[one: 1, two: 2]`

与语言无关的标量类型


`{~, null}`	空（无值）。
`[1234, 0x4D2, 02333]`	[十进制整数、十六进制整数、八进制整数]
`[1_230.15, 12.3015e+02]`	[固定浮点数，指数浮点数]
`[.inf, -.Inf, .NAN]`	[无穷大（浮点数），负数，不是数字]
`{Y, true, Yes, ON}`	布尔真
`{n, FALSE, No, off}`	布尔假

【YAML】一文掌握 YAML 的详细用法（YAML 备忘速查）

文章目录

入门

介绍

标量类型

↓ 等效的 JSON

变量

↓ 等效的 JSON

注释

多行字符串

↓ 等效的 JSON

继承

↓ 等效的 JSON

参考

↓ 等效的 JSON

折叠的字符串

↓ 等效的 JSON

两份文件

YAML Collections

序列

↓ 等效的 JSON

映射

↓ 等效的 JSON

映射到序列

↓ 等效的 JSON

映射序列

↓ 等效的 JSON

序列的序列

↓ 等效的 JSON

映射的映射

↓ 等效的 JSON

嵌套集合

↓ 等效的 JSON

无序集

↓ 等效的 JSON

有序映射

↓ 等效的 JSON

YAML 参考

条款

文档指标

收集指标

别名指标

特殊键

标量指标

标签属性（通常未指定）

杂项指标

核心类型（默认自动标签）

转义码

Numeric

Protective

C

额外的

更多类型

与语言无关的标量类型