GitHub Actions：仅修改.md文件时PR仍要求CI执行的问题解决

问题核心：用paths-ignore跳过.md文件修改的CI触发后，分支保护规则因缺少CI状态检查记录而阻止PR合并。解决方案是让CI始终触发，仅在确认只有.md文件修改时跳过核心测试步骤，直接标记为成功。

具体实现步骤 #

1. 移除paths-ignore配置
   打开仓库的.github/workflows/ci.yml，删除原有的paths-ignore字段，让所有PR和push都能触发CI流程。

2. 添加文件修改判断步骤
   在CI的job中加入步骤，检查当前提交/PR的修改文件是否仅包含.md格式：

   jobs:
     ci:
       runs-on: ubuntu-latest
       steps:
         - name: Checkout code
           uses: actions/checkout@v4
           with:
             fetch-depth: 0 # 拉取完整提交历史用于对比文件差异
   
         - name: Detect non-documentation changes
           id: check-changes
           run: |
             # 根据事件类型获取差异文件列表
             if [[ "${{ github.event_name }}" == "pull_request" ]]; then
               modified_files=$(git diff --name-only origin/${{ github.base_ref }}...HEAD)
             else
               modified_files=$(git diff --name-only HEAD~1...HEAD)
             fi
             # 判断是否存在非.md文件修改
             if echo "$modified_files" | grep -qvE '\.md$'; then
               echo "has_non_md=true" >> "$GITHUB_OUTPUT"
             else
               echo "has_non_md=false" >> "$GITHUB_OUTPUT"
             fi
   

3. 条件执行CI核心步骤
   给原有的构建、测试等核心步骤添加条件，仅当存在非.md文件修改时才执行；同时添加步骤，在仅修改.md文件时直接标记CI成功：

   - name: Run full build & test
           if: steps.check-changes.outputs.has_non_md == 'true'
           # 保留原有的CI核心逻辑，比如编译、单元测试等步骤
           run: |
             dotnet build
             dotnet test
   
         - name: Docs-only changes - skip tests
           if: steps.check-changes.outputs.has_non_md == 'false'
           run: echo "Only Markdown docs modified, CI marked as successful"
   

原理说明 #

• paths-ignore会直接阻止Workflow触发，导致分支保护规则要求的“CI状态检查”缺失，从而无法合并PR。
• 上述方案让Workflow始终触发，通过判断修改内容决定是否执行核心测试：
  • 存在代码/配置修改时，正常跑完整CI；
  • 仅修改文档时，快速跳过测试并标记成功，满足分支保护的状态检查要求。

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