如何基于特定文件夹变更触发Azure DevOps(VSTS)条件构建（Yarn Workspaces）

我之前帮团队搭建过Yarn Workspaces在Azure DevOps上的条件构建流程，刚好能解决你已经实现分支触发、现在要扩展到文件夹维度的需求。下面是具体的实现思路和步骤：

1. 核心：利用Azure DevOps的路径过滤规则 #

Azure DevOps的CI/PR触发器支持通过paths字段精准控制哪些文件夹/文件的变更会触发构建，这是实现文件夹维度触发的基础。你只需要在azure-pipelines.yml中配置trigger.paths（针对分支推送）和pr.paths（针对PR）即可。

2. 适配Yarn Workspaces结构的基础配置 #

假设你的Yarn Workspaces项目结构是这样的：

root/
├── packages/
│   ├── package-a/
│   ├── package-b/
│   └── package-c/
├── package.json
├── yarn.lock
└── azure-pipelines.yml

2.1 基础触发器配置（只触发指定子包变更） #

如果希望只有package-a的变更（包括其下所有文件）触发构建，同时根目录的依赖配置（package.json、yarn.lock）变更也触发，可以这样写：

# 针对分支推送的触发器
trigger:
  branches:
    include:
      - main  # 你已配置的目标分支
  paths:
    include:
      - packages/package-a/**/*  # 监听package-a下所有文件变更
      - package.json             # 根依赖变更触发构建
      - yarn.lock
    exclude:
      - README.md                # 排除不需要触发的文件（可选）

# 针对PR的触发器（如果需要的话）
pr:
  branches:
    include:
      - main
  paths:
    include:
      - packages/package-a/**/*
      - package.json
      - yarn.lock

2.2 多子包分别触发对应构建任务 #

如果你的流水线需要根据不同子包的变更，执行对应的构建任务（比如package-a变更只跑package-a的构建，package-b变更只跑package-b的构建），可以通过变更检测脚本+任务条件实现：

第一步：添加变更检测任务

在流水线开头加一个任务，用Git命令检测本次提交变更的文件路径，然后设置对应的变量：

jobs:
- job: Detect_Changed_Packages
  displayName: '检测变更的子包'
  steps:
    - powershell: |
        # 获取本次提交与上一次提交的变更文件列表
        try {
          $changedFiles = git diff --name-only HEAD HEAD~1
        } catch {
          # 如果是首次构建（无上一次提交），默认所有子包都需要构建
          $changedFiles = Get-ChildItem -Path packages -Recurse | Select-Object -ExpandProperty FullName
        }

        # 检测每个子包是否有变更
        foreach ($file in $changedFiles) {
          if ($file -like 'packages/package-a/*') {
            Write-Host "##vso[task.setvariable variable=BuildPackageA;isOutput=true]true"
          }
          if ($file -like 'packages/package-b/*') {
            Write-Host "##vso[task.setvariable variable=BuildPackageB;isOutput=true]true"
          }
          if ($file -like 'packages/package-c/*') {
            Write-Host "##vso[task.setvariable variable=BuildPackageC;isOutput=true]true"
          }
        }

        # 如果根依赖变更，标记所有子包需要构建
        if ($changedFiles -contains 'package.json' -or $changedFiles -contains 'yarn.lock') {
          Write-Host "##vso[task.setvariable variable=BuildPackageA;isOutput=true]true"
          Write-Host "##vso[task.setvariable variable=BuildPackageB;isOutput=true]true"
          Write-Host "##vso[task.setvariable variable=BuildPackageC;isOutput=true]true"
        }
      name: ChangeDetection

第二步：根据变量执行对应子包的构建

后续的构建任务通过dependsOn和condition关联变更检测任务的输出变量，只在对应子包有变更时执行：

- job: Build_Package_A
  displayName: '构建Package A'
  dependsOn: Detect_Changed_Packages
  condition: eq(dependencies.Detect_Changed_Packages.outputs['ChangeDetection.BuildPackageA'], 'true')
  steps:
    - script: yarn install --frozen-lockfile
      displayName: '安装依赖'
    - script: yarn workspace package-a build
      displayName: '执行Package A构建'

- job: Build_Package_B
  displayName: '构建Package B'
  dependsOn: Detect_Changed_Packages
  condition: eq(dependencies.Detect_Changed_Packages.outputs['ChangeDetection.BuildPackageB'], 'true')
  steps:
    - script: yarn install --frozen-lockfile
      displayName: '安装依赖'
    - script: yarn workspace package-b build
      displayName: '执行Package B构建'

- job: Build_Package_C
  displayName: '构建Package C'
  dependsOn: Detect_Changed_Packages
  condition: eq(dependencies.Detect_Changed_Packages.outputs['ChangeDetection.BuildPackageC'], 'true')
  steps:
    - script: yarn install --frozen-lockfile
      displayName: '安装依赖'
    - script: yarn workspace package-c build
      displayName: '执行Package C构建'

3. 注意事项 #

• 路径语法细节：**/*表示匹配文件夹下所有子目录和文件，路径要从根目录开始写（不要加./前缀）
• 首次构建处理：上面的脚本已经考虑了首次构建的情况，会默认触发所有子包构建，你可以根据需求调整逻辑
• PR触发适配：如果需要PR也支持文件夹维度触发，记得在pr.paths中配置相同的路径规则
• 测试验证：可以手动修改某个子包的文件提交，或者在Azure DevOps流水线页面点击「Run pipeline」→「Customize」，查看触发器的路径过滤是否生效

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