YAML中Array与Dictionary的定义及书写结构有何差异
YAML中Array(序列)与Dictionary(映射)的定义差异
首先明确一个前置认知:YAML 原生语法体系里没有直接使用 Array、Dictionary 的类型命名,和你在 Python 中熟悉的两类数据结构完全对应的两个YAML原生结构分别是序列(Sequence,对应Array)、映射(Mapping,对应Dictionary),二者的书写规则、结构特征、值定位逻辑有明确边界,完全可以通过书写特征直接区分。
核心书写规则差异
这是编写YAML时最直观的判断依据,没有模糊空间:
- 序列(对应Array):层级内的所有条目必须以
-作为前缀开头,条目按书写顺序依次排列,不存在自定义的名称标识。
对应Python列表的YAML写法示例:# 结构解析后等价于 Python 中的 ["apple", "banana", "orange"] fruit_basket: - apple - banana - orange - 映射(对应Dictionary):层级内的所有条目必须以
键名: 值的固定格式书写,键和值是一一配对的关系,不存在前置的-标记。
对应Python字典的YAML写法示例:# 结构解析后等价于 Python 中的 {"apple": 5, "banana": 3, "orange": 4} fruit_price: apple: 5 banana: 3 orange: 4
值访问逻辑差异
这部分和你已经熟悉的Python访问逻辑完全对齐,不存在额外的语法偏差:
- 序列(Array)的定位逻辑:必须通过从0开始的整数索引访问对应位置的值,无法通过自定义名称匹配条目。和Python列表的访问逻辑完全一致,比如上面示例里的
fruit_basket,取第一个元素时,不管是解析为Python对象,还是YAML内部的跨节点引用语法,都是按位置索引取值,不存在通过键名定位条目的原生支持。 - 映射(Dictionary)的定位逻辑:必须通过预先定义的自定义键名访问对应的值,无法通过整数顺序索引作为原生访问入口。和Python字典的访问逻辑完全一致,比如上面示例里的
fruit_price,要取苹果的价格,只能通过键名apple匹配取值,不支持直接按顺序取第N个条目的值。
易混淆的边界场景说明
实际编写时出现的判断困惑,基本都来自嵌套结构和不规范写法带来的认知偏差,记住两个核心判断逻辑即可避开所有误区:
- 只要某一层级下的条目前面带有
-标记,这一层的结构就属于序列(Array),哪怕-后面跟着的是完整的键值对,本质上也只是“数组元素为字典”的嵌套结构,顶层结构仍然是Array。比如下面的写法:
这个结构解析后等价于Python中的# 本质是Array:每个元素是一个单独的字典 fruit_details: - name: apple price: 5 - name: banana price: 3[{"name": "apple", "price":5}, {"name":"banana", "price":3}],整体属于数组类型,不属于字典。 - 只要某一层级下的条目没有
-标记,全部是键: 值格式,这一层的结构就属于映射(Dictionary),哪怕键名没有按照常规的短文本格式书写,本质上也还是键值对结构。
快速判断口诀:当前层级全是带
-开头的条目,就是Array;当前层级全是键: 值的配对条目,就是Dictionary。
内容的提问来源于stack exchange,提问作者Brown Caveman-Hudson Mbong
相关产品推荐
相关产品推荐

