YAML 入门：配置文件格式全解析

什么是 YAML

YAML 是 "YAML Ain't Markup Language" 的缩写，这是一种用于数据序列化的基于文本的标记语言。

YAML 的用途

YAML (YAML Ain't Markup Language) 是一种人类可读的数据序列化格式，主要用于以下目的：

作为配置文件格式： 许多编程语言和框架采用 YAML 作为配置文件的格式。
作为应用程序之间的数据交换格式： YAML 常和 JSON 一起被用作数据交换格式。
描述结构化数据： YAML 可用于描述文档、产品信息、各种元数据等。

YAML 是一个重要的数据序列化格式，广泛应用于各种场景，如编程语言中的数据结构序列化/反序列化、容器编排工具的清单文件描述、各类配置文件定义等。YAML 是 API 文档的标准格式之一，这是 YAML 的主要应用场景之一。

YAML 的特点

作为一种方便人类阅读和书写的语言，YAML 具有以下显著特点：

数据可以以人类易读易写的格式进行书写。
比 JSON 更简洁的语法。
空白字符（空格和制表符）具有特殊意义，因此缩进很重要。
能够包含注释。
能够表示数据类型，例如字符串、数字、数组和对象。

由于这些特点，使用 YAML 进行书写非常方便。在接下来的部分，我们将介绍如何编写 YAML 文件，以便不太熟悉的人更好地掌握。

如何编写 YAML

在 YAML 中，数据通常表示为 键值对。多个键值对可以通过缩进来分隔。以下是编写 YAML 的基本步骤。

使用键值对

在 YAML 中，数据主要通过键值对来表示，这样的键值对以冒号 (:) 分隔。

key: value

编写数据层级

当存在数据层级时，使用缩进（通常为两个空格）来继续描述下级对象。

parent:
  child: value

编写列表和条目

数组使用短划线（-）来书写。如果有多个条目，每个条目必须以短划线开头。

fruits:
  - apple
  - orange
  - banana

编写对象

对象也使用键值对，但需要使用缩进。

user:
  name: Taro
  age: 23

编写注释

要在 YAML 中编写注释，使用井号 (#)。注释从井号开始，延续到该行的末尾。

# 这是一个注释

# 你还可以在值旁边写注释
key: value  # 注释

# 注释可以跨越多行
long_commented_key: |
  此值在
  注释后继续。

# 嵌套结构（如 JSON）也可以有注释
parent:
  # 子元素的注释
  child_key: child_value

# 在列表中也可以使用注释
shopping_list:
  - milk  # 2 升
  - eggs  # 10 个
  - bread

注释规则包括：

从 # 到行末的部分被视为注释。
注释可以放在值的前面或后面。
可以在标量值的上方或下方编写注释。
注释可以跨越多行。

通过添加注释，可以提高文件的清晰度和可读性，特别是对于配置文件或文档化内容。

编写多行字符串

要在 YAML 文件中编写多行字符串，使用竖线 (|) 包围内容。

text: |
  XXXX
  YYYY

遵循这些规则，您可以轻松编写 YAML 文件。与 JSON 相比，主要区别在于缩进和空白字符在 YAML 中是有意义的。因此，如果您熟悉 JSON，在使用 YAML 进行编写时需要特别注意这些差异。

YAML 文件示例

以下是一个完整的 YAML 文件示例，这有助于您更好地理解如何编写 YAML 文件。

# 样本 YAML文件

# 字典（映射）
book:
  title: Introduction to YAML
  author:
    # 嵌套的映射
    name: Yamada Taro
    age: 38
  year: 2023
  pages: 120
  chapters:
    # 列表
    - Introduction
    - Basics
    - Advanced Techniques

# 列表
fruits:
  - apple
  - orange
  - banana

# 字符串
description: |
  YAML 是一个人类友好的数据序列化标准。
  它通常用于配置文件和 API 中。

# 数值
price: 9.99

# 布尔值
published: true

# 空值
score: ~

这个 YAML 文件表示如下数据结构：

以 book: 开头的块定义了一个字典（映射）。