Azure Pipeline模板无法引用根级变量的问题求助

问题场景 #

主管道定义了根级变量test，直接在主管道的任务中用${{ variables.test }}可以正常输出变量值，但将任务放到模板文件中后，同样的模板语法引用会输出空值。且需要在${{ if eq(variables['test'], 'asdf') }}这类编译时条件中使用该变量，宏语法（$[ ]）无法满足需求。

主管道代码：

variables:
- name: test
  value: asdf

stages:
- stage: 
  jobs:
    - job: test_job
      steps:
        - script: echo "${{ variables.test }}"
    - template: ./test.yaml

模板文件test.yaml代码：

jobs:
  - job: test
    steps:
      - script: echo "${{ variables.test }}" 

原因分析 #

Azure DevOps的YAML模板在编译时解析（即${{ }}表达式的处理阶段），模板拥有独立的上下文环境，不会自动继承主管道的根级变量。主管道内的任务属于主上下文，可直接访问根变量；但模板作为独立的解析单元，默认只能访问自身定义的变量或通过参数传入的值，因此直接用${{ variables.test }}无法获取到主管道的根变量。

解决方案 #

方法：通过模板参数传递根变量 #

这是最规范且适配编译时条件的解决方案，通过显式参数传递，将主管道的根变量注入到模板的编译时上下文中。

1. 修改主管道，调用模板时传递参数：

variables:
- name: test
  value: asdf

stages:
- stage: 
  jobs:
    - job: test_job
      steps:
        - script: echo "${{ variables.test }}"
    - template: ./test.yaml
      parameters:
        testVar: ${{ variables.test }}  # 将根变量作为参数传入模板

2. 修改模板文件，定义参数并使用：

parameters:
- name: testVar
  type: string
  default: ""  # 可选：设置默认值

jobs:
  - job: test
    steps:
      - script: echo "${{ parameters.testVar }}"
      # 编译时条件判断示例
      - script: echo "变量值匹配成功"
        ${{ if eq(parameters.testVar, 'asdf') }}:
          displayName: "仅当testVar为asdf时执行"

这种方式既能在脚本中输出变量值，也能满足编译时条件判断的需求，同时保证模板的可复用性和上下文清晰性。

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