Azure DevOps YAML流水线paths exclude触发器未按预期生效

你碰到的路径排除规则不生效问题，是Azure DevOps YAML流水线的几个已知机制导致的，和你写的YAML语法本身无关：

• 路径排除规则的生效逻辑不是「只要改了排除列表里的文件就不触发」，而是只有当单次提交的所有变更文件全部命中exclude列表时，才会跳过CI运行。只要提交里存在任意一个不在exclude列表、同时匹配分支规则的文件，整个提交都会触发流水线。
• 如果你曾经在流水线UI设置里开启过「覆盖YAML触发器」配置，哪怕之后改回使用YAML配置，系统可能残留缓存的默认触发规则，直接忽略YAML文件里写的整个paths配置段，变成master分支任意提交都触发。
• 路径匹配是大小写敏感、且要求从仓库根目录开始的完整相对路径，如果你写的排除文件路径和仓库实际路径不一致（比如文件在子目录你只写了文件名、大小写不匹配），排除规则就会失效。
• 同仓库下多个YAML流水线共存时，隐式触发判定会遍历所有YAML文件的触发规则，如果你没有做双向的路径隔离，很容易出现重复触发。

按以下步骤操作就能彻底解决重复触发问题：

• 先清理UI端的触发器缓存配置
  进入对应常规流水线的编辑页，打开右上角更多菜单里的「触发器」面板，找到YAML触发器配置项，确认完全关闭「覆盖持续集成触发器」选项，保存配置后刷新页面，确保系统完全读取YAML文件里定义的触发规则，没有残留的手动配置。
• 校准排除路径的写法
  核对exclude列表里的文件路径，确保和仓库根目录下的实际路径、文件名大小写完全一致。如果azure-pipelines-prod.yaml存放在子目录下，必须补全完整路径，比如存放在pipelines目录下就要写pipelines/azure-pipelines-prod.yaml，不能只写文件名。
• 给两个流水线配置完全互斥的触发路径
  不要只靠exclude规则拦截，建议同时显式配置include路径，明确每个流水线的触发范围，避免隐式匹配导致的误触发：
  • 常规环境流水线（azure-pipelines.yaml）参考配置：

trigger:
  batch: true
  branches:
    include:
    - master
  paths:
    include:
    # 列全所有常规环境需要触发的路径，比如业务代码目录、非生产配置目录
    - src/
    - config/
    exclude:
    # 列全所有生产专属的文件、路径
    - config/luna-tenant-bio-annotation-prod.yaml
    - azure-pipelines-prod.yaml

• 生产专属流水线（azure-pipelines-prod.yaml）里，除了你已经配置的dev/test/stage路径排除，还要把常规流水线的YAML文件azure-pipelines.yaml加入排除列表，保证两个流水线的触发范围没有重叠。
• 生效验证
  单独提交一次仅修改azure-pipelines-prod.yaml的变更，不要携带任何其他文件，观察常规流水线是否触发：如果不触发说明配置生效；如果还是触发，回到第一步检查UI配置和路径拼写。

注意：如果开启了PR触发器，还要在pr配置段里加一模一样的paths排除规则，否则PR合并前的校验运行也会出现重复触发的问题。

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