Azure DevOps模板中如何引用matrix变量至作业模板？报错处理

错误原因分析 #

你遇到的报错是因为matrix对象仅在Job的策略定义块（比如pool、Job级variables等Job顶级属性）内可直接引用。当在steps中传递模板参数时，matrix对象不在当前表达式的作用域内，因此无法直接通过matrix.env_region访问。

两种可行解决方案 #

方案一：通过Job级变量中转 #

先将matrix变量存入Job级变量，再传递给模板参数（编译时解析，适合需要提前确定值的场景）：

pipeline.yml 修正后代码

jobs:
- job: Deploy
  strategy:
    matrix:
      westus:
        env_region: westus
      eastus:
        env_region: eastus
  # 把matrix变量转存为Job级变量
  variables:
    current_region: ${{ matrix.env_region }}
  pool:
    name: 'Pool-${{ matrix.env_region }}' # 此处仍可直接用matrix
  steps:
  - template: my-job-template.yml
    parameters:
      region: ${{ variables.current_region }} # 传递中转后的变量

方案二：使用运行时变量语法 #

直接用$(变量名)的运行时变量格式传递（运行时解析，适合模板参数支持动态值的场景）：

pipeline.yml 修正后代码

jobs:
- job: Deploy
  strategy:
    matrix:
      westus:
        env_region: westus
      eastus:
        env_region: eastus
  pool:
    name: 'Pool-${{ matrix.env_region }}'
  steps:
  - template: my-job-template.yml
    parameters:
      region: $(env_region) # 直接用运行时变量引用matrix定义的env_region

模板参数定义示例 #

确保my-job-template.yml中正确定义接收参数：

parameters:
- name: region
  type: string
  default: ''

steps:
- script: echo "当前部署区域：${{ parameters.region }}"

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