如何在GitHub工作流中仅校验PR提交的commitlint合规性？

• 工作流未合并到主分支也触发运行的原因：GitHub Actions 的 pull_request 事件触发规则为，只要发起 PR 的源分支携带对应路径的工作流配置文件，PR 创建、更新时就会自动触发对应流程，不要求工作流配置必须已合并到目标主分支。你发起 PR 的分支本身就包含 commitlint 工作流配置，自然会正常触发运行。
• 校验范围命中主分支历史提交的原因：原配置中 HEAD~${{ github.event.pull_request.commits }} 的范围计算逻辑存在天然缺陷。pull_request 事件下，Actions 默认检出的代码是 GitHub 生成的 PR 模拟合并临时节点，并非功能分支自身的提交序列。基于这个临时节点往前按提交数量偏移，很容易直接跨越分支分叉点，命中主分支上的历史旧提交，导致校验范围完全失控。

完全不需要对主分支全量历史执行 rebase、批量修改旧提交信息，只要调整 commitlint 的范围参数，把校验边界固定在 PR 的实际分叉点上即可。核心逻辑是 用明确的提交 SHA 值代替偏移量计算校验范围：

• 校验起点固定为 PR 基分支的最新提交 SHA，也就是主分支和功能分支的分叉节点
• 校验终点固定为 PR 源分支的最新提交 SHA，也就是本次 PR 待合并的所有提交的最顶端
• 两个边界之间的提交，就是本次 PR 从主分支拉出后新增的全部提交，完全不会覆盖主分支上的历史旧提交

调整后的完整工作流配置如下，仅替换原范围计算的命令行即可，其余逻辑保持原有配置：

name: Run commitlint on pull request

on: pull_request

jobs:
  run-commitlint-on-pull-request:
    runs-on: ubuntu-latest

    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0 # 必须保留全量历史拉取配置，否则commitlint无法定位两个SHA之间的完整提交链

      - name: Setup Node
        uses: actions/setup-node@v4
        with:
          node-version: lts/*

      - name: Install dependencies
        run: npm install

      - name: Validate all commits from PR
        # 替换原有的偏移量计算逻辑，通过PR的基/头分支SHA划定精准校验范围
        run: npx commitlint --from ${{ github.event.pull_request.base.sha }} --to ${{ github.event.pull_request.head.sha }} --verbose

• 不要依赖 github.event.pull_request.commits 的计数结果做偏移量计算：PR 一旦有更新推送、合并变基，提交数量和位置就会变化，基于计数的偏移逻辑永远有概率算错范围
• 必须保留 fetch-depth: 0 的配置：如果只拉取最近 N 条提交的浅克隆，commitlint 找不到两个边界 SHA 对应的提交节点，会直接抛出范围无效的错误
• 不要把 commitlint 的校验范围设置为全仓库提交：只要主分支存在一条不合规的旧提交，所有后续 PR 的校验都会无差别失败，这是配置逻辑问题，不是历史代码的问题

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