Azure DevOps YAML模板判断变量非空执行步骤 引用异常排查

该问题由Azure DevOps YAML的模板编译上下文作用域规则导致：

• 模板中使用的${{ }}是编译期表达式，在流水线启动后、正式执行前的模板展开阶段就完成计算，这个阶段仅能识别三类值：流水线根层级YAML定义的变量、GUI界面配置的队列/流水线变量、系统预定义的编译期可见变量。
• 你定义在stage（同理job）层级的变量属于对应阶段/作业的运行时局部上下文，不会在模板编译阶段加载到全局变量表，因此模板内的编译期判断读取variables.number会得到空值。GUI设置的变量属于全局编译期可见变量，因此原有写法可以正常生效。

根据是否需要编译期裁剪流水线结构，可选择以下两种标准实现方式：

方案1：显式传参+编译期条件（官方推荐） #

模板不要隐式依赖外层变量，通过参数显式接收需要的值，编译期会直接裁剪掉不符合条件的步骤，最终生成的流水线定义中不会包含无效步骤，执行效率最高，模板复用性最好。

1. 修改模板文件run.yml，定义入参并基于参数做编译期判断：

parameters:
- name: number
  type: string
  default: ''

steps:
- ${{ if ne(parameters.number, '') }}:
  - powershell: Write-Host "Its working! number value is ${{ parameters.number }}"

2. 修改流水线调用模板的位置，显式将stage层级的变量编译期值传入模板：

stages:
- stage: Run
  variables:
    - name: number
      value: '123'
  jobs:
  - job:
    steps:
    - template: .\run.yml
      parameters:
        number: ${{ variables.number }}

方案2：运行时条件判断（无需修改调用逻辑） #

如果不想改动现有模板的调用方式，可以放弃编译期判断，改用步骤的condition字段做运行时判断。该判断在步骤实际执行前计算，此时所有作用域（根、stage、job）的变量都已完成加载，可以正常读取stage层级定义的变量。
该方案的缺点是：无论变量是否为空，步骤都会被包含在最终展开的流水线结构中，仅在运行时被跳过，不会实际执行。
直接修改run.yml即可，无需调整流水线调用配置：

- powershell: Write-Host "Its working!"
  condition: ne(variables['number'], '')

补充兼容写法 #

如果要保留原有模板内直接读取variables.number做编译期判断的逻辑，只需要将number变量从stage层级提升到流水线根层级定义即可。但这种写法会让模板强依赖全局变量，多环境复用时容易出现变量污染，不推荐使用：

# 根层级定义的变量可在模板编译期被识别
variables:
  - name: number
    value: '123'

stages:
- stage: Run
  jobs:
  - job:
    steps:
    - template: .\run.yml

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