YAML文件規則

Gitee 位置

配置文件規則 YAML-YML文件

YAML - ‘Yet another markup language’. 也是一種標記語言

但由於其主要目的是表達數據而不是標記，因此也說是 ‘YAML Ain’t a Markup Language’的遞歸縮寫。

YAML的語法和其他高級語言類似，並且可以簡單表達清單、散列表，標量等數據形態。

支持的數據類型

1. 數字（包含整數和浮點數）
2. 字符串（使用雙引號引用）
3. boolean（部分解析器支持）
4. 序列化數據（例如：JSON等，部分解析器支持）

文件規則

1. Yaml使用 UTF-8或者UTF-16編寫

2. 註釋使用#符號

   # 本行爲註釋行，從# 開始到行未
   

3. 支持Map數據類型,使用:標識，冒號後需要跟一位空格

   name: value
   # 冒號後有空格
   

4. 支持數組類型，每個數組值佔一行，每行開頭以-（減號）標識，後面跟上一位空格

   arrays:
     - value1
     - value2
    # 注意縮進
   

5. 縮進採用空格的方式（TAB理論上也可以，部分解析器不支持）

   空格數量沒有明確定義，只要能夠表明同一層級對齊即可

   first_level_name1: 
      second_level_name1: second_level_value1
      second_level_name2:
          third_level_name1: 
           - third_level_value1
           - third_level_value2
           - third_level_value3 
      second_level_name3: second_level_value3
   first_level_name2: first_level_name2
   

6. 使用---分割文件，用於多配置一文件情況

   part1.....
   ---
   part2.....
   

7. 部分解析器可支持!!的數據類型強制轉換，不推薦使用

   name: !!str 123 # 123爲數字類型被強制轉換爲字符串類型
   

擴展

Yaml支持用戶自定義變量，根鬚需求不同，轉換方式不同，用戶根據使用的平臺進行獲取。