如何配置GitHub仓库，使其在存在无效提交消息时拒绝所有推送变更

首先明确：GitHub没有提供开箱即用的、在推送请求到达时直接硬拦截不合规提交的原生配置能力，但可以通过「自定义工作流+强制分支保护规则」的组合，实现你要求的全部校验规则，且彻底解决本地Git Hook可被用户随意删除、绕过的问题。

具体配置步骤 #

1. 编写面向推送事件的自定义校验工作流 #

在仓库的专属工作流目录下新建配置文件，将工作流的触发时机设置为全量push事件，工作流内部的校验逻辑完全匹配你的规则：

• 拉取本次推送涉及的所有提交：对比推送前后的分支引用位置，遍历该区间内的全部提交，完整读取每条提交的原始消息，避免漏检
• 逐条执行校验逻辑：
  • 用正则拆分每条提交消息的type、issue编号、message三个组成部分，校验type是否在你预设的白名单（feat、fix、ci等）内，不满足时直接输出自定义错误提示：Rejected because 'xxx' is not a valid type
  • 调用仓库内置接口查询对应编号的issue是否真实存在，不存在时输出错误提示：Rejected because the issue doesn't exist
  • 提取冒号后的正文内容，裁剪前后空白后检查长度，内容为空时输出错误提示：Rejected because the message is empty
• 只要任意一条提交不满足规则，直接让工作流以非零状态退出，标记为校验失败。

2. 联动分支保护规则实现强制拦截 #

进入仓库设置的受保护分支配置页，完成两个关键配置：

• 开启「要求状态检查通过才能合并」选项，将上述提交校验工作流加入必须通过的检查列表，保证所有想进入受保护分支的变更，必须先通过提交消息校验
• 开启「禁止绕过以上设置」选项，保证即使是仓库维护者，也不能跳过校验直接推送、合并违规内容

方案边界说明 #

• 这套配置的拦截时机是代码推送完成后、合并进入受保护分支前，校验不通过的内容不会被合并，且所有提交都会被做全量校验，不存在用户通过删除本地hook、强制提交绕开的可能
• 如果你要求的是「推送请求刚到达GitHub网关时就直接拒绝、不将违规提交存入仓库对象」的效果，目前GitHub不对普通仓库开放自定义服务端pre-receive钩子的配置入口，这类能力仅面向企业版定制场景提供
• 所有错误提示支持完全自定义，可完全匹配你要求的精准报错格式，不会出现模糊的通用提示

方案对比本地Git Hook的优势 #

• 校验逻辑完全托管在GitHub侧，用户本地的任何操作都无法绕开
• 所有提交的校验标准全局统一，不会出现不同开发者本地hook规则不一致的问题
• 校验结果会直接展示在PR、推送通知的页面上，不需要人工逐条翻阅提交历史做检查

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