一、YAML是什么？

YAML 首次發表于2001 年，其官方文檔給出的描述：

“YAML Ain’t Markup Language” (abbreviated YAML) is a data serialization language designed to be human-friendly and work well with modern programming languages for common everyday tasks.

“YAML 不是標記語言 ”（縮寫為 YAML）是一種 數據序列化語言 ，旨在 對人類友好 ，并且可以與現代編程語言很好地配合完成常見的 日常任務 。

不是標記語言 ： 誰是標記語言，XML就是。XML被設計為與標準通用標記語言 (SGML) 向后兼容，SGML 旨在支持結構化文檔。了解更多XML知識：XML是什么與為什么

數據序列化語言 ： 使用yaml承載來數據，并在程序之間傳遞，這部分職責與XML、JSON相似。

對人類友好 ： 使得非專業人士也能輕松閱讀。

編程語言日常任務 ： 程序本身的屬性、依賴關系表達，程序運行過程產生的數據，程序之間數據的傳遞等這些任務，都要以一種形態表達出來，常見的有：配置文件、日志文件、進程間消息傳遞、跨語言數據共享等等。

二、YAML為什么產生？

YAML的產生是為了：提高人們對“數據交換格式”的可讀性；數據可在編程語言之間交換。

而JSON的產生是為了：簡單性和通用性。JSON的生成和解析很簡單，但人類的可讀性相對差些。

三、YAML長啥樣？

先來直觀地看看YAML文件（docker-compose），不求甚解。

复制version: "3.7"

services:
  app:
    image: node:12-alpine
    command: sh -c "yarn install && yarn run dev"
    ports:
      - 3000:3000
    working_dir: /app
    volumes:
      - ./:/app
    environment:
      MYSQL_HOST: mysql
      MYSQL_USER: root
      MYSQL_PASSWORD: secret
      MYSQL_DB: todos

  mysql:
    image: mysql:5.7
    volumes:
      - todo-mysql-data:/var/lib/mysql
    environment:
      MYSQL_ROOT_PASSWORD: secret
      MYSQL_DATABASE: todos

volumes:
  todo-mysql-data:

四、YAML文件怎么看？

1. 了解YAML約定與語法

（1）約定

大小寫敏感；

層級關系使用縮進來表示（用空格，不用TAB鍵；敲幾個空格不限，但相同層級左側要對齊）；

注釋使用 # ， # 前帶空格；

內容塊：起始使用 --- ；結束使用 ... ；

重復內容的定義：錨點標簽&表達被引用的內容，*表達引用。

（2）語法

總的來說，支持的基本數據結構： 對象 、列表以及純量 。

對象： 也稱字典，使用key:value來表達。

表達方式一：

复制Key1:
  key11: value11
  Key12: value12

表達方式二：

复制Key1: { key11: value11, child-key12: value12 }

列表 ： 也稱序列、數組。

表達方式一：

复制values:
  - value1
  - value2
  - value3

表達方式二：

复制values: [value1, value2, value3]

純量 ： Null、布爾、字符串、整數、浮點數、日期和時間等基本數據類型。

2. 領域YAML規范約定

不同領域都有各自的YAML規范約定。

第三部分的YAML文件是docker-compose，其規范約定在Compose Specification中，詳細內容參見鏈接3