Azure DevOps YAML模板if条件无法传入运行时变量的原因

问题根因 #

你写的判断逻辑用错了表达式类型，${{ if eq(...) }}属于模板编译期表达式，求值时机是流水线YAML加载编译阶段，这个阶段第一个PowerShell任务根本还没运行，自然拿不到你通过echo "##vso[task.setvariable]"动态设置的运行时变量，判断时variables.os_name为空，永远匹配不上'linux'的条件。

两类表达式的核心差异 #

• ${{ <expression> }} 模板表达式：流水线启动前的编译阶段就完成计算，只能读取编译阶段就已经确定值的内容，比如流水线参数、YAML里提前静态定义的变量、固定的系统预定义变量，完全拿不到任务运行时动态生成的变量。
• $[ <expression> ] 运行时表达式：在对应任务实际执行前才会求值，可以读取前序任务运行时设置的变量、任务输出变量等动态内容。

修正写法 #

不要用模板级的if条件判断动态变量，改成给目标任务加condition字段，用运行时表达式判断即可，修正后的代码如下：

- powershell: |
    $os_name = 'linux'
    echo "##vso[task.setvariable variable=os_name;]$os_name"
  displayName: 'Set os_name runtime variable'

- powershell: |
    echo "variables.os_name = linux"
  displayName: 'Run steps for Linux'
  condition: eq(variables.os_name, 'linux')

额外注意事项 #

• 如果设置的变量需要跨作业（Job）引用，在setvariable时要加isOutput=true参数，引用时需要带上设置变量的任务名，格式为variables['<设置变量的任务名>.os_name']
• 如果需要根据动态变量控制整个作业/阶段的执行逻辑，同样要在作业/阶段的condition字段用运行时表达式判断，不能用模板if语法。

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