YAML管道运行时变量无法在模板条件/表达式中使用的解决方法

这是Azure DevOps YAML管道的语法执行时机差异导致的必然结果，三种语法的执行阶段完全隔离，不能跨阶段取值：

• ${{ }} 模板表达式：管道编译展开阶段执行，此时还未调度、运行任何Job/Task，只能读取YAML中静态定义的Parameters、硬编码变量值，所有运行时才会生成的值（Task设置的输出变量、运行时才解析的资源字段、跨Job传递的变量）在这个阶段要么是空值，要么是未解析的原始表达式字符串，不可能拿到实际运行值。
• $[ ] 运行时表达式：Job/Stage调度阶段解析，可以拿到前置依赖的输出、系统预定义的运行时变量，但解析时机早于当前Job内的Task执行，无法读取同Job内后续Task才会设置的变量。
• $(变量名) 宏语法：单个Task执行前做文本替换，可以拿到所有前置步骤设置的变量，但仅做字符串替换，无法控制YAML结构层面的逻辑（比如判断整个Step/Job是否要加载、是否要执行）。

根据使用场景选对应方案即可：

方案1：将编译期条件下沉为运行时条件 #

不要用${{ if }}做结构级的判断，改用YAML原生支持的运行时condition字段，该字段在运行时调度Step/Job时才做判断，可以直接识别运行时变量、跨Job输出变量。
你原本要实现的模板判断逻辑：

- ${{ if and(eq(parameters.checkinUpdatedSubmoduleCommits, true), eq(variables['isDevBranch'], true)) }}:
  # <Do some work>

直接修改为挂载到对应Step/Job上的运行时条件即可：

# 挂在Step上的示例
- powershell: |
    # 你原本要执行的工作逻辑
  condition: and(
    eq(parameters.checkinUpdatedSubmoduleCommits, true),
    eq(dependencies.A.outputs['setVar.isDevBranchOut'], true)
  )

注意：跨Job输出变量在condition中使用时不需要提前赋值给当前Job的局部变量，直接写全依赖路径即可正常判断。

方案2：编译期可确定的值不要放到运行时计算 #

你当前判断是否为Dev分支的逻辑，完全不需要单独跑一个PowerShell Task在运行时计算——仓库资源的ref值在编译期就可以直接读取，直接在调用方管道将判断结果作为参数传给模板即可，不需要绕运行时设置变量。
修改callingPipeline.yaml中引用模板的传参部分：

jobs:
  - template: 'template.yaml'
    parameters:
      buildConfiguration: '${{ parameters.buildConfiguration }}'
      checkinUpdatedSubmoduleCommits: '${{ parameters.checkinUpdatedSubmoduleCommits }}'
      # 编译期直接计算分支判断结果，作为静态参数传入模板
      isDevBranch: ${{ eq(resources.repositories['Repo-MyProj'].ref, 'refs/heads/DevBranch') }}

同时在template.yaml的parameters段增加对应boolean类型的isDevBranch参数，此时你原本写的${{ if }}模板判断就可以正常生效，因为参数值在编译期已经是确定的布尔值，不需要等待运行时计算。

方案3：判断逻辑完全依赖运行时数据时，下沉到脚本内部判断 #

如果你的判断条件依赖运行时才能获取的数据（比如拉取代码后才读取的配置文件内容、调用外部接口返回的规则判定结果），就不要试图用YAML层面的条件控制，直接把判断逻辑写到具体执行的脚本内部：

# 在执行业务逻辑的脚本内直接做判断
if ($env:CHECKIN_UPDATED_SUBMODULE -eq "True" -and $env:IS_DEV_BRANCH -eq "True") {
  # 放置需要条件触发的业务逻辑
}

• 静态定义的statVar可以在${{ }}表达式中拿到正确值：因为该变量是YAML中硬编码的静态值，编译阶段就存在。
• isDevBranch在模板表达式中返回未解析的表达式字符串、判断结果为False：因为编译阶段$[ dependencies.A.outputs['setVar.isDevBranchOut'] ]这个运行时表达式还未被解析，模板层只能读到原始字符串，和布尔值true做相等判断自然返回False。
• $(reporef)可以在脚本中正确打印分支名，但模板表达式判断为False：因为reporef赋值的是运行时表达式，编译阶段拿不到解析后的实际分支值，只有Task执行前做宏替换时才会被替换为真实的分支字符串。

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