Azure DevOps：是否需显式向模板传递变量/变量组？

核心结论 #

主管道中定义的变量、链接的变量组，默认会自动继承给被调用的模板，不需要显式作为参数传递——但前提是变量组已正确链接到主管道的对应作用域（根级别、作业级别均可）。测试失败大概率是变量组的链接方式或作用域配置有误。

问题排查与修改方案 #

假设你当前的主管道和模板存在变量组未正确链接的问题，以下是修正后的完整写法：

1. 主管道正确链接变量组 #

根据变量组的作用范围，有两种配置方式：

方式一：根级别链接（所有作业/模板共享）

# azure-pipelines.yml
variables:
- group: commonGroup  # 根级别绑定，全管道可见
- group: stageGroup

jobs:
- job: TestJob
  steps:
  - template: template.yml

方式二：作业级别链接（仅当前作业内的模板可见）

# azure-pipelines.yml
jobs:
- job: TestJob
  variables:
  - group: commonGroup
  - group: stageGroup
  steps:
  - template: template.yml

2. 模板中直接访问继承变量 #

模板内无需额外配置，直接用$(变量名)即可调用继承的变量：

# template.yml
steps:
- script: |
    echo "commonGroup 变量 varC: $(varC)"
    echo "stageGroup 变量 varD: $(varD)"
    # 调试用：输出所有可用环境变量
    printenv
  displayName: '输出所有变量'

特殊场景：需要显式传递变量的情况 #

只有以下两种情况需要显式传递变量给模板：

• 变量是作业内的局部临时变量，且模板需要单独引用
• 需要对模板参数做自定义控制（比如设置默认值、重命名变量）

示例写法：

# azure-pipelines.yml
jobs:
- job: TestJob
  variables:
  - group: commonGroup
  - name: localTempVar
    value: '临时测试值'
  steps:
  - template: template.yml
    parameters:
      customVar: $(localTempVar)  # 显式传递局部变量

# template.yml
parameters:
- name: customVar
  type: string
  default: '默认值'

steps:
- script: |
    echo "继承的 varC: $(varC)"
    echo "显式传递的 customVar: ${{ parameters.customVar }}"

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