主播最近在公司学习go相关内容,修改了一年,结果发现就是.yaml文件的缩进不对,给主播气的直接简单学习了一下这个yaml文件
简介
YAML(YAML Ain’t Markup Language)是一种人类可读的数据序列化格式,广泛用于配置文件、数据交换等场景
特点
简洁易读:使用缩进和简单符号表示数据结构。
跨语言支持:支持多种编程语言(如Python、Java、Go等)。
扩展性:支持注释、复杂数据结构和引用。
语法规则
缩进
用空格(非Tab)表示层级关系,同一层级必须对齐。
缩进数量通常为2或4个空格(推荐2个)。
注释
#开头 例:
# 这是一行注释
key: value # 行内注释
键值对
使用 key: value 形式,冒号后必须加空格:
name: "Alice"
age: 30
数据类型
对象(Mapping)
表示以键值对(key: value)形式出现的数据
- 使用“冒号+空格”来分开键与值
key: value
// JSON
"key": "value"
- 支持多层嵌套(用缩进表示层级关系)
key:
child-key1: value1
child-key2: value2
// JSON
"key": {
"child-key1": "value1",
"child-key2": "value2",
}
- 支持流式风格( Flow style)的语法(用花括号包裹,用逗号加空格分隔,类似 JSON)
key: { child-key1: value1, child-key2: value2 }
// JSON
"key": { "child-key1": "value1", "child-key2": "value2" }
- 使用问号“?”声明一个复杂对象,允许你使用多个词汇(数组)来组成键
?
- keypart1
- keypart2
:
- value1
- value2
数组(Sequence)
- 一组以区块格式(Block Format)(即“破折号+空格”)开头的数据组成一个数组
values:
- value1
- value2
- value3
// JSON
"values": [ "value1", "value2", "value3" ]
- 同时也支持内联格式(Inline Format)来表达(用方括号包裹,逗号加空格分隔,类似 JSON)
values: [value1, value2, value3]
// JSON
"values": [ "value1", "value2", "value3" ]
- 支持多维数组(用缩进表示层级关系)
values:
-
- value1
- value2
-
- value3
- value4
// JSON
"values": [ [ "value1", "value2"], ["value3", "value4"] ]
标量(Scalars)
表示 YAML 中最基本的数据类型
字符串(String)
字符串一般不需要用引号包裹,但是如果字符串中使用了反斜杠“\”开头的转义字符就必须使用引号包裹
strings:
- Hello without quote # 不用引号包裹
- Hello
world # 拆成多行后会自动在中间添加空格
- 'Hello with single quotes' # 单引号包裹
- "Hello with double quotes" # 双引号包裹
- "I am fine. \u263A" # 使用双引号包裹时支持 Unicode 编码
- "\x0d\x0a is \r\n" # 使用双引号包裹时还支持 Hex 编码
- 'He said: "Hello!"' # 单双引号支持嵌套"
// JSON
"strings":
[ "Hello without quote",
"Hello world",
"Hello with single quotes",
"Hello with double quotes",
"I am fine. ☺",
"\r\n is \r\n",
"He said: 'Hello!'" ]
对于多行的文字,YAML 提供了两种特殊的语法支持
保留换行(Newlines preserved)
使用竖线符“ | ”来表示该语法,每行的缩进和行尾空白都会被去掉,而额外的缩进会被保留
lines: |
我是第一行
我是第二行
我是吴彦祖
我是第四行
我是第五行
// JSON
"lines": "我是第一行\n我是第二行\n 我是吴彦祖\n 我是第四行\n我是第五行"
- 折叠换行(Newlines folded)
使用右尖括号“ > ”来表示该语法,只有空白行才会被识别为换行,原来的换行符都会被转换成空格
lines: >
我是第一行
我也是第一行
我仍是第一行
我依旧是第一行
我是第二行
这么巧我也是第二行
// JSON
"lines": "我是第一行 我也是第一行 我仍是第一行 我依旧是第一行\n我是第二行 这么巧我也是第二行"
布尔值(Boolean)
“true”、“True”、“TRUE”、“yes”、“Yes”和“YES”皆为真
“false”、“False”、“FALSE”、“no”、“No”和“NO”皆为假
boolean:
- true # True、TRUE
- yes # Yes、YES
- false # False、FALSE
- no # No、NO
// JSON
"boolean": [ true, true, false, false ]
整数(Integer)
支持二进制表示
int:
- 666
- 0001_0000 # 二进制表示
// JSON
"int": [ 666, 4096 ]
浮点数(Floating Point)
支持科学计数法
float:
- 3.14
- 6.8523015e+5 # 使用科学计数法
// JSON
"float": [ 3.14, 685230.15 ]
空(Null)
“null”、“Null”和“~”都是空,不指定值默认也是空
nulls:
- null
- Null
- ~
-
// JSON
"nulls": [ null, null, null, null ]
时间戳(Timestamp)
YAML 也支持 ISO 8601 格式的时间数据
这里使用 JavaScript 对象进行对比
date1: 2020-05-26
date2: 2020-05-26T01:00:00+08:00
dete3: 2020-05-26T02:00:00.10+08:00
date4: 2020-05-26 03:00:00.10 +8
// JavaScript
date1: Tue May 26 2020 08:00:00 GMT+0800 (中国标准时间),
date2: Tue May 26 2020 01:00:00 GMT+0800 (中国标准时间),
dete3: Tue May 26 2020 02:00:00 GMT+0800 (中国标准时间),
date4: Tue May 26 2020 03:00:00 GMT+0800 (中国标准时间)
类型转换
YAML 支持使用严格类型标签“!!”(双感叹号+目标类型)来强制转换类型
a: !!float '666' # !! 为严格类型标签
b: '666' # 其实双引号也算是类型转换符
c: !!str 666 # 整数转为字符串
d: !!str 666.66 # 浮点数转为字符串
e: !!str true # 布尔值转为字符串
f: !!str yes # 布尔值转为字符串
// JSON
"a": 666,
"b": "666",
"c": "666",
"d": "666.66",
"e": "true"
"f": "yes"