首页/开发/CI/CD 与发布速查/GitHub Actions 路径过滤与必需检查
工具链要点63 条

GitHub Actions 路径过滤与必需检查

push/pull_request 可按 paths 过滤触发范围节省算力;但与分支保护的必需状态检查叠加时,未触发的工作流会阻塞合并。

CI/CD 与发布速查开发更新于 2026-10-12
写法paths: ['src/**']、paths-ignore
效果不满足路径条件则不创建运行
陷阱必需检查长期缺失导致 PR 无法合并
对策保留总是运行的轻量占位检查

路径过滤

路径过滤
on:
  pull_request:
    paths:
      - 'src/**'
      - 'package-lock.json'
分支保护要求某检查必须通过时:路径过滤会让不相关改动无法合并,需用占位作业保全检查名。

易错点

  • 过滤规则过细:关键文件变更没有触发流水线
  • 把必需检查叠加到可跳过的工作流上:PR 被卡住

数据来源与参考

  • GitHub Docs《Workflow syntax》(paths)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌