ADO YAML模板如何处理少量平台依赖任务？

问题背景 #

将经典ADO管道迁移至YAML管道时，希望通过带isWindows参数的通用模板实现跨平台兼容，但遇到了依赖检查问题：即使通过condition禁用Windows专属的CmdLine任务，Linux代理仍会报错找不到满足Cmd需求的代理——原因是ADO在管道初始化阶段就会解析所有任务的依赖需求，condition仅能控制任务是否执行，无法跳过依赖检查。

可行解决方案 #

方案1：用模板表达式（${{ if }}）替代condition #

模板表达式在编译阶段执行，会直接移除不满足条件的任务，从根源上避免不必要的依赖需求。修改common-template.yml如下：

parameters:
- name: isWindows
  type: boolean

jobs:
- job: MyJob
  steps:
  - checkout: none
    clean: true

  # 跨平台脚本任务
  - bash: |
      env
    displayName: Print Environment

  # ... 更多跨平台任务

  # Windows专属任务：编译阶段直接决定是否包含该任务
  ${{ if eq(parameters.isWindows, true) }}:
    - task: CmdLine@2
      inputs:
        filename: scripts\windows_only.bat

  # ... 更多跨平台任务

  # 分平台实现的任务
  ${{ if eq(parameters.isWindows, true) }}:
    - task: CmdLine@2
      inputs:
        filename: scripts\task_a.bat
  ${{ else }}:
    - task: Bash@3
      inputs:
        filePath: scripts/task_a.sh

  # ... 更多跨平台任务

方案2：基于Agent.OS自动适配（无需手动传参） #

利用ADO代理内置变量Agent.OS，让管道自动根据代理系统选择对应任务，无需手动传递isWindows参数：
修改common-template.yml：

jobs:
- job: MyJob
  steps:
  - checkout: none
    clean: true

  # 跨平台脚本任务
  - bash: |
      env
    displayName: Print Environment

  # ... 更多跨平台任务

  # Windows专属任务
  ${{ if eq(variables['Agent.OS'], 'Windows_NT') }}:
    - task: CmdLine@2
      inputs:
        filename: scripts\windows_only.bat

  # ... 更多跨平台任务

  # 分平台任务
  ${{ if eq(variables['Agent.OS'], 'Windows_NT') }}:
    - task: CmdLine@2
      inputs:
        filename: scripts\task_a.bat
  ${{ else }}:
    - task: Bash@3
      inputs:
        filePath: scripts/task_a.sh

  # ... 更多跨平台任务

对应的主管道可简化为：
Windows版本：

trigger: none

pool:
  name: BuildPool
  demands:
  - Agent.OS -equals Windows_NT

extends:
  template: common-template.yml

Linux版本：

trigger: none

pool:
  name: BuildPool
  demands:
  - Agent.OS -equals Linux

extends:
  template: common-template.yml

关键区别说明 #

• condition：运行阶段生效，仅控制任务是否执行，但任务定义已被解析，依赖需求会提前添加；
• ${{ if }}：编译阶段生效，直接移除不符合条件的任务，不会产生多余的依赖需求。

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