Azure Pipeline作业内修改变量后传递给模板参数不生效问题

架构老林

2026-9-2

配置错误根因

核心问题是混淆了Azure DevOps YAML流水线的两个完全独立的执行周期：

模板展开、参数赋值属于编译期逻辑：流水线启动后会第一时间把所有引用的模板展开、计算所有模板参数的取值，这时候所有作业（job）、步骤（step）都还没开始运行，你写在step里修改变量的逻辑根本没有执行，此时给模板传$(test_var)取到的只能是流水线初始化时定义的初始值firstval。
##vso[task.setvariable] 属于运行期逻辑：它修改变量的效果仅对同一个job内、执行顺序在它之后的步骤生效，默认既不能跨job传递，更不可能反向修改编译期就已经固化的模板参数值。你观察到第二个variable pass步骤输出secondValue，只是因为这个步骤和修改变量的步骤在同一个job内，属于运行时变量的正常作用范围，不代表这个修改能影响到编译期就确定的模板参数。

另外你的配置还有一处缩进错误：第二个echo步骤（显示second variable pass的步骤）下错误缩进了name: Env和displayName: "Extract Source Branch Name"两行配置，这两行不属于该步骤，会导致步骤配置异常，需要调整缩进层级。

修复方法

要让运行时修改的变量能正常传递到模板对应的作业，不能依赖编译期传参，需要用跨作业输出变量+作业依赖的机制实现，具体修改步骤：

修改主yml中设置变量的bash步骤，标记该变量为输出变量，并给步骤设置固定名称，方便后续跨job引用：

- bash: echo "##vso[task.setvariable variable=test_var;isOutput=true]secondValue"
  name: setVarStep # 步骤名自定义，后续引用要对应
  displayName: set new variable value

调整模板引用的配置，给模板对应的job显式声明依赖运行修改变量步骤的BuildDeploy作业，等BuildDeploy跑完再启动模板作业，同时通过运行时表达式拉取前序作业输出的变量值：

- template: pipeline_templates/ci_pipeline_templates/build_deploy_dev.yml
  dependsOn: BuildDeploy # 必须声明依赖，否则拿不到前序job的输出
  variables:
    passed_test_var: $[ dependencies.BuildDeploy.outputs['setVarStep.test_var'] ]
  parameters:
    testvar: $(passed_test_var)

调整模板内的变量取值方式，不要用编译期模板表达式${{ parameters.testvar }}取值（该语法会在编译期直接把值替换为固定字符串），改用运行时变量语法$(testvar)取值即可拿到修改后的值：
```
parameters:
  - name: testvar

jobs:
    - job: Test
      displayName: "Testjob"
      steps:
        - script: echo "test_var=$(testvar)"
          name: TestVar
          displayName: 'test'
```

如果不想通过模板参数传递，也可以直接在模板作业内通过dependencies语法引用前序job的输出变量，本质逻辑一致。注意task.setvariable没有所谓「永久生效」的全局设置，所有跨job、跨stage的变量传递都必须显式声明输出、显式声明依赖才能拿到值。

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