Azure Pipelines：system.debug变量在模板条件中失效的解决问询

你遇到的核心问题是编译时表达式与运行时变量的生命周期不匹配：

• ${{ }} 属于编译时表达式，管道在开始执行前就会解析这类表达式，决定要加载哪些任务/模板。
• 勾选「系统诊断」复选框设置的 system.debug=true 是运行时系统变量，这个值在编译阶段还未被注入管道，所以编译时表达式无法读取到它，导致条件判断不成立，模板任务不会被加载。
• 而你手动在 variables 块中声明的 system.debug 是编译时变量，编译阶段就能读取到，所以条件判断生效。

根据你的需求，推荐两种可行方案：

方案1：使用运行时条件（推荐） #

将条件判断从编译时的 ${{ if }} 改为任务的 condition 字段（运行时判断）。这样模板会被正常加载，但只有当 system.debug 为 true 时才执行任务。注意运行时的 system.debug 值是字符串类型的 'true'，而非布尔值：

- template: ./steps/devops/print-directory.yaml
  parameters:
    displayName: "[Debug] List Pipeline Workspace files"
    folder: $(Pipeline.Workspace)
  condition: eq(variables['system.debug'], 'true')

方案2：通过参数控制模板加载（适合需动态加载模板的场景） #

如果希望只有调试模式下才加载模板（而非加载后不执行），可以在管道顶层定义一个布尔参数，触发管道时手动勾选：

parameters:
  - name: enableDebugTasks
    type: boolean
    default: false

# 编译时判断参数，决定是否加载模板
- ${{ if eq(parameters.enableDebugTasks, true) }}:
  - template: ./steps/devops/print-directory.yaml
    parameters:
      displayName: "[Debug] List Pipeline Workspace files"
      folder: $(Pipeline.Workspace)

触发管道时，手动勾选 enableDebugTasks 参数即可加载调试任务，同时可结合勾选「系统诊断」开启调试日志。

补充说明 #

• 系统变量 system.debug 在编译阶段不可访问，因为它是运行时由系统注入的，所以无法用编译时表达式判断它的值。
• 运行时条件 condition 会在任务执行前进行判断，此时已经能获取到 system.debug 的值，因此可以正常生效。

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