Azure Pipeline Python脚本设置变量跨作业模板传值失效如何修复

配置失效来自4个核心逻辑错误：

• 模板表达式 ${{ variables.xxx }} 属于编译期静态求值，在流水线启动、作业调度前就会被替换为固定的初始值，完全无法读取运行时通过##vso[task.setvariable]动态设置的变量值。
• task.setvariable 默认设置的变量作用域仅限当前作业内的后续步骤，跨作业、跨模板引用的作业默认无法访问，必须显式标记为输出变量才能跨作业传递。
• PowerShell 中重复调用$(.\script.py)会导致Python脚本执行两次，且Python顶层代码中写return result属于无效语法——Python仅支持在函数/方法内部使用return，脚本执行的标准输出（print打印内容）就是可被捕获的返回结果，不需要额外写return。
• 跨作业引用动态变量必须显式声明作业依赖关系，通过运行时表达式取值，直接给模板传编译期表达式永远只能拿到初始默认值。

1. 修正Python脚本 #

移除无效的顶层return语句，仅保留业务逻辑和print输出：

result = "XYZ"
# 此处替换为实际读取外部文件的业务逻辑
print(result)

2. 修正上游变量生产作业配置 #

给输出变量的任务加唯一名称，执行Python脚本时仅调用一次、捕获输出到本地变量，设置变量时开启输出标记，运行时读变量使用$(变量名)语法，禁止在需要动态取值的位置使用编译期${{}}表达式：

jobs:
  - job: SetVariableJob
    variables:
      myVariable: 'default-value'
    steps:
      - checkout: self # 确保脚本文件被拉取到执行环境
      - task: PowerShell@2
        name: SetVarStep # 必须配置任务名称，供下游定位输出变量
        displayName: "Set dynamic variable from Python script"
        inputs:
          targetType: "inline"
          script: |
            # 单次执行Python脚本，捕获标准输出到本地变量
            $MY_VARIABLE = python .\script.py
            Write-Host "Captured value from script: $MY_VARIABLE"

            # 打印初始变量值，使用运行时取值语法
            Write-Host "Initial variable value before update: $(myVariable)"
            # 标记为输出变量，允许跨作业访问
            Write-Host "##vso[task.setvariable variable=myVariable;isOutput=true]$MY_VARIABLE"

3. 修正下游模板作业的变量传递 #

下游作业必须显式声明对上游生产变量作业的依赖，使用运行时表达式$[ dependencies.<上游作业名>.outputs['<任务名>.<变量名>'] ]读取动态值，将该运行时表达式作为参数传给模板即可：

jobs:
  - job: SetVariableJob
    # 省略上述已修正的作业配置

  - job: ConsumeTemplateJob
    dependsOn: SetVariableJob # 必须声明依赖，等待上游作业执行完成后再调度
    variables:
      # 可先将跨作业变量映射为当前作业的本地变量方便复用
      dynamicInput: $[ dependencies.SetVariableJob.outputs['SetVarStep.myVariable'] ]
    steps:
      - template: .ci/other-job.yml
        parameters:
          # 传入运行时表达式，禁止使用编译期${{}}语法传动态值
          input: $[ dependencies.SetVariableJob.outputs['SetVarStep.myVariable'] ]

注意：如果引用的模板内部包含独立作业，只需要在模板入参处传入上述运行时表达式即可，模板内部不需要额外修改变量作用域配置，运行时会自动计算拿到动态生成的变量值。

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