咨询私有GitHub仓库仅允许rc分支合并至master的实现方案

结论 #

完全可以用Git的pre-push hook实现你的需求——仅允许基于rc分支的变更推送至master，拦截所有不符合规则的推送操作。

具体实现脚本 #

在仓库的.git/hooks/目录下创建无后缀的pre-push文件，写入以下脚本：

#!/bin/bash

remote="$1"
url="$2"

# 拉取远程最新代码，确保判断基于最新状态
git fetch "$remote" >/dev/null 2>&1

# 遍历所有待推送的分支映射
while read local_ref local_sha remote_ref remote_sha; do
    remote_branch=$(basename "$remote_ref")
    
    # 仅针对master分支做校验
    if [ "$remote_branch" = "master" ]; then
        # 获取远程rc分支的最新提交SHA
        remote_rc_sha=$(git rev-parse "$remote/rc")
        
        # 检查远程rc的最新提交是否是本地待推送master的祖先（即已合并rc）
        if ! git merge-base --is-ancestor "$remote_rc_sha" "$local_sha"; then
            echo "❌ 推送拒绝：仅允许从rc分支合并至master后推送，当前master分支未包含rc的最新变更"
            exit 1
        fi
    fi
done

exit 0

给脚本添加执行权限：

chmod +x .git/hooks/pre-push

脚本说明 #

• 核心逻辑：当尝试推送至master时，校验本地待推送的master分支是否已经合并了远程rc的最新代码，确保所有master的变更都来自经过QA测试的rc分支。
• git fetch步骤用于同步远程rc的最新状态，避免开发人员基于旧版rc合并后推送。
• 如果团队允许直接从本地rc分支推送到master（而非合并后推master），可以调整脚本为校验本地分支是否为rc：

  # 替换上述分支校验部分
  local_branch=$(basename "$local_ref")
  if [ "$local_branch" != "rc" ]; then
      echo "❌ 推送拒绝：仅允许rc分支推送至master，当前分支为$local_branch"
      exit 1
  fi
  

注意事项 #

• pre-push是本地钩子，需要确保所有团队成员都在本地仓库配置该钩子。可以把脚本放在仓库的scripts/目录下，配合README说明让大家复制到.git/hooks/目录。
• 脚本逻辑可根据团队实际流程微调，比如是否允许紧急修复的特殊情况（可添加白名单逻辑）。

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