Azure Pipelines：模板表达式与condition/dependsOn的优劣及选型建议

在Azure Pipelines中，我们可以通过模板表达式（${{ if }}）和condition子句两种方式实现阶段/作业的动态执行，两者核心区别在于执行时机：模板表达式是**编译时（流水线启动前）处理，condition是运行时（流水线执行过程中）**处理，各自的优缺点和适用场景如下：

一、模板表达式（${{ if ... }}） #

优点 #

• 流水线界面更简洁：不满足条件的阶段/作业会直接从最终运行的流水线定义中移除，不会在界面上显示“跳过”状态，整体流程更清爽。
• 资源零消耗：未触发的阶段不会被Azure Pipelines初始化，完全不占用Agent或流水线资源。
• 模板复用性强：可以和循环、变量替换等其他模板语法结合，快速生成多环境、多分支的流水线配置，比如根据分支列表动态生成对应部署阶段。

缺点 #

• 仅支持编译时变量：只能使用流水线启动时就确定的变量（如Build.SourceBranchName、Build.Reason），无法调用运行时生成的变量（如前序作业输出的自定义变量、手动输入的运行时参数）。
• 调试难度高：如果表达式编写错误，要么流水线编译直接失败，要么目标阶段直接消失，没有“跳过日志”可用于排查问题。
• 无法基于阶段结果判断：编译时无法预知前序阶段的运行状态（成功/失败），因此不能实现“前阶段成功才执行当前阶段”这类逻辑。

示例代码：

stages:
- ${{ if eq(variables['Build.SourceBranchName'], 'development') }}:
      - stage: Deploy
        dependsOn: Build
        displayName: "Deploying to development environment."
        jobs:
          - deployment:
            environment: MyEnvironment
            strategy:
              runOnce:
                deploy:
                  steps:
                    - task: AzureRmWebAppDeployment@4
                      inputs:
                        ConnectionType: "AzureRM"
                        azureSubscription: "MySubscription"
                        appType: webAppContainer
                        WebAppName: $(environmentName)
                        DockerNamespace: $(ContainerRegistry)
                        DockerRepository: appRepo
                        DockerImageTag: development-$(Build.BuildId)

二、condition子句 #

优点 #

• 支持运行时动态判断：可以结合前序阶段的运行结果（如succeeded()、failed()）、运行时生成的变量（如作业输出变量）来决定是否执行当前阶段，比如“Build成功且手动参数为true时才部署”。
• 调试更直观：不满足条件的阶段会在流水线界面显示为“跳过”，可以查看详细的跳过原因日志，便于排查问题。
• 流程灵活性高：可以实现复杂的分支逻辑，比如某测试阶段失败后，跳过部署但执行通知作业。

缺点 #

• 存在轻微资源开销：即使阶段被跳过，Azure Pipelines依然会初始化该阶段的上下文，虽然不会运行作业，但会占用少量流水线资源。
• YAML定义更冗余：所有可能的阶段都需要写在配置文件中，无论是否会被执行，对于复杂流水线来说，YAML会显得冗长。
• 界面略显杂乱：大量跳过的阶段会出现在流水线的阶段列表中，影响整体视觉简洁度。

示例代码：

- stage: DeployHomolog
    dependsOn: Build
    condition: and(succeeded(), eq(variables['Build.SourceBranchName'], 'dev'))
    displayName: "Deploying to Homolog Environment"
    jobs:
      - deployment:
        environment: MyEnvironment
        strategy:
          runOnce:
            deploy:
              steps:
                - task: AzureRmWebAppDeployment@4
                  inputs:
                    ConnectionType: "AzureRM"
                    azureSubscription: "MySubscription"
                    appType: webAppContainer
                    WebAppName: WebApp
                    DockerNamespace: $(acr)
                    DockerRepository: appRepo
                    DockerImageTag: dev-$(Build.BuildId)

三、选型建议 #

• 优先用模板表达式：当你需要基于编译时确定的条件（如分支名、流水线触发方式）来控制阶段是否存在，或者希望流水线界面简洁、最大化节省资源时，选择模板表达式。
• 优先用condition：当你需要基于运行时动态数据（如前序阶段结果、运行时变量、手动参数）来决定是否执行阶段，或者需要保留跳过阶段的调试日志时，选择condition子句。

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