Azure DevOps构建管道：标签与路径过滤器共存时触发失效

这个问题的核心在于Azure DevOps的触发器逻辑：当你同时配置分支、路径和标签过滤器时，所有过滤器条件必须同时满足才会触发构建。也就是说，标签对应的提交不仅要匹配标签过滤器，还得满足路径过滤器（即该提交必须包含/src/SomeFolder1下的文件变更）——如果你的标签是基于没有修改该路径的提交创建的，自然不会触发构建。而移除路径过滤器后，只有分支和标签过滤器生效，所以标签触发恢复正常。

解决方案：通过条件判断绕过标签触发的路径限制 #

你不需要移除任何过滤器，只需要在构建任务级别添加条件，让标签触发时忽略路径过滤器的约束。以下是具体配置方式：

1. YAML管道配置

在你的YAML文件中，保留原有的触发器配置，然后在job块中添加条件表达式：

trigger:
  branches:
    include:
      - '*'
  tags:
    include:
      - 'v*'
  paths:
    include:
      - '/src/SomeFolder1'

jobs:
- job: MainBuild
  # 条件：要么是分支提交且满足路径过滤，要么是标签触发（忽略路径）
  condition: |
    or(
      and(
        eq(variables['Build.Reason'], 'IndividualCI'),
        not(startsWith(variables['Build.SourceBranch'], 'refs/tags/v'))
      ),
      startsWith(variables['Build.SourceBranch'], 'refs/tags/v')
    )
  displayName: 'Main Build Job'
  steps:
    # 这里添加你的构建步骤，比如：
    - script: dotnet build --configuration Release
      displayName: 'Build Project'

2. 经典编辑器配置（非YAML）

如果你使用的是经典可视化编辑器：

• 保持原有的分支、路径、标签过滤器配置不变
• 进入构建任务的控制选项，在“运行此任务”中选择“自定义条件”，输入以下表达式：

  or(eq(variables['Build.Reason'], 'IndividualCI'), startsWith(variables['Build.SourceBranch'], 'refs/tags/v'))
  

原理说明 #

这个配置的核心是利用Azure DevOps的预定义变量：

• Build.SourceBranch：当触发源是标签时，该变量的值为refs/tags/v1.0.0这类格式
• Build.Reason：分支提交触发时为IndividualCI，标签触发时为Manual或IndividualCI（取决于标签创建方式）

通过条件判断，我们让两种场景都能触发构建：

1. 分支提交且路径匹配的常规场景
2. 标签触发的场景，无论路径是否有变更

这样既保留了路径过滤器对分支提交的限制，又确保标签能正常触发构建。

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