Azure Pipelines YAML中使用If条件选择模板引用时失效问题求助

你遇到的问题核心是Azure Pipelines中模板表达式（${{ if }}）和步骤条件（condition字段）的执行时机完全不同：

• 步骤里的condition是运行时条件：在job实际运行时才会评估，这时候Agent.JobName已经被填充为当前job的实际名称（比如BBB_1），所以startsWith判断能正常工作。
• 而${{ if }}是编译时表达式：在管道开始运行前的解析阶段就会被执行，这时候Agent.JobName这种运行时变量还没有任何值（是空字符串），所以你的startsWith(variables['Agent.JobName'], 'BBB_')判断永远返回false，自然会走到else块。

你尝试的${{ if startsWith('$(Agent.JobName)', 'BBB_') }}写法也无效，因为编译时$(Agent.JobName)只是一个字面量字符串，不是变量替换，判断的是字符串"$(Agent.JobName)"是否以BBB_开头，显然不成立。

因为模板表达式只能访问编译时就存在的变量，比如矩阵中定义的变量、管道参数、预定义的编译时变量等，我们可以利用这一点来调整逻辑：

方案1：给矩阵项添加标识变量 #

直接在矩阵的每个job项中添加一个标识变量，用来标记是否是BBB类的job，这样编译时就能直接读取这个变量的值：

jobs:
- job:
    timeoutInMinutes: 100
    cancelTimeoutInMinutes: 10
    strategy:
      matrix:
        AAA_1:
          build: "dev"
          isBBBJob: false  # 添加标识
        BBB_1:
          build: "release"
          isBBBJob: true   # 添加标识
        BBB_2:
          build: "rc-1"
          isBBBJob: true   # 添加标识
    steps:
    - checkout: repo-to-checkout
      fetchDepth: 1
      path: s/path-to-checkout
      clean: true
      condition: startsWith(variables['Agent.JobName'], 'BBB_')
    - ${{ if eq(variables.isBBBJob, true) }}:
      - template: build-template.yml@templates
        parameters:
          param1: $(build)
    - ${{ else }}:
      - template: build-another-template.yml@templates
        parameters:
          param1: $(build)

方案2：通过矩阵中的build变量判断 #

如果不想额外添加标识变量，可以直接利用已有的build变量值来做编译时判断（因为build是矩阵中定义的，编译时就能拿到）：

jobs:
- job:
    timeoutInMinutes: 100
    cancelTimeoutInMinutes: 10
    strategy:
      matrix:
        AAA_1:
          build: "dev"
        BBB_1:
          build: "release"
        BBB_2:
          build: "rc-1"
    steps:
    - checkout: repo-to-checkout
      fetchDepth: 1
      path: s/path-to-checkout
      clean: true
      condition: startsWith(variables['Agent.JobName'], 'BBB_')
    - ${{ if or(eq(variables.build, 'release'), startsWith(variables.build, 'rc-')) }}:
      - template: build-template.yml@templates
        parameters:
          param1: $(build)
    - ${{ else }}:
      - template: build-another-template.yml@templates
        parameters:
          param1: $(build)

记住Azure Pipelines的两个核心阶段：

1. 编译阶段：解析管道YAML，处理所有${{ ... }}表达式，这时候只能访问编译时变量（矩阵变量、参数、System.DefinitionId等预定义编译变量）。
2. 运行阶段：执行job和步骤，处理condition、variables中的运行时变量（Agent.*、Build.*等）。

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