路径过滤与选择性构建
在单体仓库和多仓库环境中，使用路径过滤器、变更检测和条件矩阵，仅触发受变更影响的工作流和任务
路径过滤与选择性构建 是 CoddyKit 上的免费 DevOps Bootcamp 课时。 这是第 4 节课，共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 DevOps Bootcamp 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 DevOps Bootcamp 课程共包含 4 节课。
浪费构建的问题
在单体仓库中，文档的变更不应该触发后端、前端和移动应用的重新构建与重新部署。
选择性构建只运行流水线中受变更影响的部分，从而节省时间和运行器执行时长。
触发器上的路径过滤器
最简单的方法是在触发器上使用 paths 过滤器。只有匹配该模式的文件发生变更时，工作流才会运行。
on:
push:
paths:
- 'services/api/**'忽略路径
您也可以使用 paths-ignore 执行反向操作：除列出的路径之外，其他变更都会运行工作流。
这对于跳过仅涉及文档变更的 CI 很方便。
on:
push:
paths-ignore:
- 'docs/**'
- '**.md'触发器过滤器的局限
触发器级别的过滤器决定整个工作流是否运行。但在单体仓库中，您通常希望由一个工作流决定运行哪些作业。
为此，您可以在工作流内部检测变更，并根据结果分支执行。
变更检测 action
dorny/paths-filter action 会检查差异，并针对每个命名的路径组输出布尔值。
后续作业会读取这些输出，以决定是否运行。
- uses: dorny/paths-filter@v3
id: changes
with:
filters: |
api:
- 'services/api/**'
web:
- 'services/web/**'根据检测到的变更控制作业
检测作业会公开输出；下游作业使用 if 和 needs 上下文来有条件地运行。
build-api:
needs: detect
if: needs.detect.outputs.api == 'true'
runs-on: ubuntu-latest
steps:
- run: ./build-api.sh连接输出
检测作业必须声明 outputs，转发过滤器结果，以便其他作业读取。
detect:
runs-on: ubuntu-latest
outputs:
api: ${{ steps.changes.outputs.api }}
web: ${{ steps.changes.outputs.web }}动态矩阵
对于许多服务，您可以根据变更的路径动态生成矩阵，这样只有发生变更的服务才会进入矩阵。
在一个作业中生成 JSON 列表，再将其传入下一个作业的矩阵。
strategy:
matrix:
service: ${{ fromJSON(needs.detect.outputs.list) }}使用 Git Diff 进行检测
您也可以使用原始 git 检测变更。将当前提交与基准进行比较，以列出发生变更的目录。
git diff --name-only origin/main...HEAD | cut -d/ -f1-2 | sort -u必需检查与跳过
请注意：如果某个必需的状态检查因没有变更而被跳过，分支保护可能会因等待该检查而阻止合并。
解决方法是添加一个始终成功的最终门控作业，并且只将它设为必需检查，由它汇总那些有条件运行的作业。
gate:
needs: [build-api, build-web]
if: always()
runs-on: ubuntu-latest
steps:
- run: echo 'all required jobs resolved'按软件包分别缓存
选择性构建与按软件包分别缓存配合良好。以每个服务的锁定文件作为缓存键，这样无关的变更就不会使缓存失效。
两者结合起来，即使仓库不断增大，也能让单体仓库流水线保持快速。
快速检查
测试您对选择性构建的理解。
回顾
您学会了只构建发生变更的部分。
paths和paths-ignore控制整个工作流是否运行- 变更检测 action 会按路径输出布尔值
- 作业使用
if和needs有条件地运行，矩阵也可以动态生成 - 添加一个
always()门控作业，以兼容必需检查
选择性构建让单体仓库 CI/CD 更快速、更经济。
常见问题解答
「路径过滤与选择性构建」课时是免费的吗？
是的 — 「路径过滤与选择性构建」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 DevOps Bootcamp 课程的其余内容，请升级到 CoddyKit PRO。 DevOps Bootcamp 课程共包含 4 节课。
「路径过滤与选择性构建」这节课中我会学到什么？
在单体仓库和多仓库环境中，使用路径过滤器、变更检测和条件矩阵，仅触发受变更影响的工作流和任务 你通过在浏览器中直接运行的动手代码来练习 DevOps Bootcamp，全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 DevOps Bootcamp 需要有经验吗？
无需任何先前经验。CoddyKit 上的 DevOps Bootcamp 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 4 节课，共 4 节。
「路径过滤与选择性构建」课时需要多长时间？
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。
我能在这节 DevOps Bootcamp 课中编写并运行代码吗？
能。每节 DevOps Bootcamp 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。
此课程中的所有课时
- 单体代码库的 CI/CD
- 跨代码库工作流
- 集中式工作流管理
- 路径过滤与选择性构建