Azure DevOps YAML管道脚本设置数组变量报错如何解决

Azure DevOps YAML 管道通过##vso[task.setvariable]日志命令设置的变量本质全是字符串类型，不支持直接存储原生数组/对象结构。
你之前的写法存在两个问题：

• Bash 环境中直接引用$myArray只会返回数组的第一个元素，不会输出完整数组内容
• 输出的非标准字符串内容会被 YAML 解析器识别为待解析的映射结构，最终抛出Expected at least one key-value pair in the mapping错误。

根据你的使用场景选以下两种方案即可，都能支持后续遍历操作：

方案1：JSON序列化存储（通用推荐） #

该方案兼容性最好，支持数组元素包含空格、特殊字符、换行等场景，跨Bash/PowerShell/不同任务类型都可使用。

1. 设置变量时，先将数组序列化为压缩后的JSON字符串再传入：

- bash: |
    # 替换为你实际获取数组的命令
    myArray=($(get-array command))
    # 通过jq将数组转为无多余格式的JSON字符串，自动处理特殊字符转义
    arrayJson=$(printf '%s\n' "${myArray[@]}" | jq -R . | jq -s -c .)
    echo "##vso[task.setvariable variable=myVar]$arrayJson"

2. 后续使用时，将JSON字符串反序列化为对应环境的数组结构再遍历，Bash环境示例：

- bash: |
    # 将JSON字符串转回Bash数组
    myArray=($(echo "$(myVar)" | jq -r '.[]'))
    # 执行遍历逻辑
    for item in "${myArray[@]}"
    do
      echo "Processing item: $item"
    done

注意：通过运行时日志命令设置的变量属于运行时变量，无法被YAML编译期的${{ each }}语法识别，如果需要在模板层做原生遍历，需要提前在parameters中定义数组传入，不能用运行时赋值的方式实现。

方案2：分隔符拼接存储（轻量场景适用） #

如果你的数组元素中不会出现自定义的特殊分隔符（比如|、;;;这类不常用的字符组合），可以用更轻量的字符串拼接方式实现：

1. 设置变量时，用指定分隔符把数组元素拼接为单字符串：

- bash: |
    myArray=($(get-array command))
    # 用|作为元素分隔符拼接字符串
    arrayStr=$(IFS='|'; echo "${myArray[*]}")
    echo "##vso[task.setvariable variable=myVar]$arrayStr"

2. 使用时按分隔符拆分回数组再遍历：

- bash: |
    # 按|分隔符拆分字符串为数组
    IFS='|' read -ra myArray <<< "$(myVar)"
    for item in "${myArray[@]}"
    do
      echo "Processing item: $item"
    done

• 不要尝试直接将Bash/PowerShell的原生数组对象直接通过setvariable命令输出，管道变量没有原生数组类型，所有结构化数据都需要先序列化为字符串再传递
• 如果数组元素包含空格、引号、换行等特殊字符，不要用分隔符方案，优先选JSON序列化方案，避免拆分时出现元素错位、转义错误

内容的提问来源于stack exchange，提问作者appix