如何在GitHub分支推送时校验提交信息语义，不符合则拒绝推送？

针对GitHub Enterprise Server（GHES）：服务器端钩子直接拦截 #

如果使用的是GitHub企业版服务器，这是唯一能在推送阶段直接拒绝违规提交的原生方案：

• 编写shell脚本，校验提交消息开头是否为feat:、fix:、update:这类指定前缀
• 在GHES的仓库设置中将脚本配置为pre-receive钩子
• 用户推送时，服务器会自动执行脚本，不符合规范则直接拒绝推送请求

示例脚本片段：

#!/bin/bash

# 遍历推送的所有提交
while read oldrev newrev refname; do
  for commit in $(git rev-list $oldrev..$newrev); do
    commit_msg=$(git log --format=%B -n 1 $commit)
    # 检查是否符合前缀要求
    if ! [[ $commit_msg =~ ^(feat|fix|update|chore|docs): ]]; then
      echo "ERROR: 提交消息不符合规范，必须以feat:/fix:/update:/chore:/docs:开头"
      exit 1
    fi
  done
done

exit 0

针对公共GitHub仓库：近似强制的校验组合 #

公共GitHub.com不开放自定义服务器端钩子，无法直接拦截推送，但可以通过以下组合把违规提交的影响降到最低：

• 强制本地钩子安装：在项目中提供pre-push钩子脚本，通过package.json（Node项目）或Makefile添加安装命令，要求开发者克隆仓库后必须执行安装，同时在CI流程中检查钩子是否配置到位
• 分支保护+状态检查：开启仓库的分支保护规则，要求目标分支的提交必须通过GitHub Actions的校验。虽然无法阻止推送，但会直接标记提交为失败状态，禁止合并，同时可配合通知机制提醒开发者修正提交消息

示例GitHub Actions配置（.github/workflows/commitlint.yml）：

name: Commit Message Lint
on: [push, pull_request]

jobs:
  lint:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0
      - uses: actions/setup-node@v4
        with:
          node-version: 20
      - run: npm install @commitlint/cli @commitlint/config-conventional
      - run: echo "module.exports = {extends: ['@commitlint/config-conventional']}" > commitlint.config.js
      - run: npx commitlint --from=HEAD~${{ github.event.commits.length }} --to=HEAD

第三方集成：用GitHub App做推送后拦截 #

可以使用现成的Commitlint类GitHub App，或者自行开发一个GitHub App监听push事件：

• 检测到违规提交后标记为失败状态
• 向提交者发送提醒通知
• 拥有仓库权限的情况下，可直接删除违规提交

这种方式属于推送后处理，并非实时拦截，但能有效阻止违规提交留存于仓库中。

内容的提问来源于stack exchange，提问作者Ali El-Sayed