You need to enable JavaScript to run this app. YAML中Array与Dictionary的定义及书写结构有何差异
优惠活动
大模型
产品
解决方案
定价
更多

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。比如下面的写法:
    # 本质是Array:每个元素是一个单独的字典
    fruit_details:
      - name: apple
        price: 5
      - name: banana
        price: 3
    
    这个结构解析后等价于Python中的[{"name": "apple", "price":5}, {"name":"banana", "price":3}],整体属于数组类型,不属于字典。
  • 只要某一层级下的条目没有-标记,全部是键: 值格式,这一层的结构就属于映射(Dictionary),哪怕键名没有按照常规的短文本格式书写,本质上也还是键值对结构。

快速判断口诀:当前层级全是带-开头的条目,就是Array;当前层级全是键: 值的配对条目,就是Dictionary。


内容的提问来源于stack exchange,提问作者Brown Caveman-Hudson Mbong

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.26 16:15:06