如何将跨阶段传递的Azure Pipeline PowerShell任务变量转为数组

核心问题原因 #

流水线传递变量时，若未正确处理字符串格式，Shell会自动将空格分隔的变量值拆分为多个独立参数，导致你直接使用.split或遍历操作时，无法识别为完整的字符串，进而解析错误。

通用解决思路 #

1. 确保变量传递时保留完整字符串：在Stage1输出或设置变量时，用双引号包裹变量值，避免Shell提前拆分。
2. 在Stage2中正确转换为数组：根据你使用的流水线工具及脚本环境，选择对应的数组转换方式。

分场景具体实现 #

场景1：Jenkins Pipeline（Groovy脚本） #

• Stage1设置变量时确保是完整字符串：

  stage('Stage1') {
    steps {
      script {
        env.TASK_LIST = "task1 task2 task3"
      }
    }
  }
  

• Stage2转换为数组并遍历：

  stage('Stage2') {
    steps {
      script {
        // 用正则匹配任意空白字符拆分，兼容多空格场景
        def taskArray = env.TASK_LIST.split(/\s+/)
        for (task in taskArray) {
          echo "Processing task: ${task}"
          // 这里添加你的业务操作
        }
      }
    }
  }
  

场景2：GitLab CI/GitHub Actions（Bash脚本） #

• Stage1传递变量（以GitLab CI为例）：

  stages:
    - stage1
    - stage2
  
  stage1:
    script:
      - echo "TASK_LIST='task1 task2 task3'" >> build.env
    artifacts:
      reports:
        dotenv: build.env
  
  stage2:
    script:
      # 用read命令将字符串转为数组，保留完整分隔逻辑
      - IFS=' ' read -r -a task_array <<< "$TASK_LIST"
      - for task in "${task_array[@]}"; do
          echo "Processing task: $task"
          # 执行你的业务操作
        done
  

  注意：必须用"$TASK_LIST"包裹变量，否则Shell会提前拆分字符串，导致转换失败。

场景3：规避常见错误 #

• 错误写法：直接遍历未包裹的变量

  # 错误：Shell会将TASK_LIST拆分为多个独立参数，无法作为数组源
  for task in $TASK_LIST; do ... done
  

• 错误写法：错误的数组赋值

  # 错误：仅将整个字符串作为数组的单个元素
  task_array=("$TASK_LIST")
  

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