如何配置可主动强制覆盖的GitHub分支保护规则

核心配置思路 #

放弃使用「允许指定角色/用户绕过必需的拉取请求」的白名单，通过以下组合配置实现需求：

• 强制所有普通推送（非强制）必须通过PR合并
• 仅允许你自己对目标分支执行强制推送操作

具体配置步骤 #

1. 设置基础分支保护规则

   • 进入仓库「Settings」→「Branches」→「Branch protection rules」，选中目标分支
   • 勾选「Require a pull request before merging」，确保普通git push必须通过PR才能合并到该分支
   • 不要勾选「Allow specified actors to bypass required pull requests」，也不要添加任何用户/角色到这个列表
   • 可选：勾选「Do not allow bypassing the above settings」，进一步强化规则的强制性

2. 配置强制推送权限

   • 在同一分支保护规则页面，找到「Allow force pushes」选项，选择「Allow force pushes for specified actors only」
   • 将你自己的GitHub账号添加到允许列表中
   • 可选：推荐勾选「Allow force pushes with lease」，相比裸--force更安全，可避免覆盖他人未推送的本地提交

效果验证 #

• 执行普通git push：会被GitHub拦截，提示需发起PR合并
• 执行git push --force或git push --force-with-lease：可直接推送，实现主动绕过规则的目的

补充说明 #

• 这种配置从根源上避免误操作：普通推送会被拦截，只有主动执行强制推送命令才能绕过保护
• 若团队其他成员需要强制推送权限，只需将其添加到「Allow force pushes」的指定列表即可

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