如何配置GitHub Actions以排除特定文件变更时触发工作流

直接修改你仓库中.github/workflows/目录下对应的工作流YAML配置文件，在触发规则中新增paths-ignore字段即可实现指定文件变更时跳过工作流触发，规则语法和.gitignore完全兼容。

配置示例 #

针对仅修改README类文档不触发构建的需求，参考如下配置：

on:
  # 针对push事件的触发规则
  push:
    branches: [ main ]
    paths-ignore:
      - 'README.md' # 仅排除根目录的README.md
      - '**/*.md' # 排除仓库所有目录下的.md后缀文档
      - 'docs/**' # 排除docs目录下所有文件
  # 如果有配置pull_request触发，同步加相同的排除规则即可
  pull_request:
    branches: [ main ]
    paths-ignore:
      - 'README.md'
      - '**/*.md'
      - 'docs/**'

注意事项 #

• 只有当单次提交的所有变更文件都命中paths-ignore规则时，才会跳过工作流运行；如果提交同时包含被排除文件和正常业务代码变更，工作流仍会正常触发
• 不要同时配置paths和paths-ignore字段，二者规则互斥
• 路径匹配支持通配符：*匹配任意非斜杠字符，**匹配任意层级的目录

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