Git：请勿推送已合并/拉取分支——分布式项目协作问题求助

我之前在类似的快速迭代分布式项目里踩过这个坑，分享几个亲测有效的实操方案，帮你管控分支合并风险：

1. 统一分支命名+定期清理冗余分支 #

首先从源头规范分支管理，避免混乱：

• 约定统一的分支命名规则，比如 feature/[任务ID]-[功能模块] 或 task/[你的用户名]-[任务描述]，这样一眼就能区分分支对应的任务，减少误操作。
• 本地定期清理已合并分支：
  • 先同步远程分支状态，清理本地失效的追踪分支：git fetch --prune
  • 批量删除本地已经合并到master的分支：git branch --merged master | grep -v "^\*" | xargs git branch -d
• 远程分支清理：在GitHub仓库的「Settings」→「Branches」里开启「Automatically delete head branches」，这样PR合并后会自动删除远程分支；也可以手动删除已合并的远程分支：git push origin --delete [分支名]

2. 强化PR工作流，把合并管控前置 #

用GitHub的Pull Request（PR）作为唯一合并入口，从流程上避免误操作：

• 要求所有任务分支必须通过PR合并到master，禁止直接向master推送代码。GitHub会自动检测分支是否已合并、是否存在冲突，提前给出提示。
• 给PR设置必填校验：比如开启「Require pull request reviews before merging」「Require status checks to pass before merging」，确保代码经过审查、CI验证后才能合并。
• 合并PR时勾选「Delete branch」选项，合并完成后立刻删除对应分支，从远程端彻底移除已完成的任务分支，避免其他人误拉取。

3. 开发前的强制同步检查流程 #

给团队约定开发前的标准操作，从个人层面规避风险：

• 每次开始新任务或继续开发已有分支前，先切换到master分支拉取最新代码：git checkout master && git pull --rebase
• 创建新分支时必须基于最新的master，避免基于旧版本代码开发导致后续冗余合并。
• 如果要继续开发某个旧分支，先检查该分支内容是否已合并到master：执行 git log --oneline master..[你的分支名]，如果没有输出，说明该分支的所有提交已经在master里了，没必要再继续开发或推送。

4. 用Git钩子自动化拦截误操作（进阶） #

如果团队需要更严格的管控，可以配置Git钩子自动检查：

• 编写pre-push钩子脚本，在推送前检查当前分支的内容是否已经存在于master中。比如：

  #!/bin/sh
  BRANCH=$(git rev-parse --abbrev-ref HEAD)
  # 跳过master分支检查
  if [ "$BRANCH" = "master" ]; then
      exit 0
  fi
  # 检查当前分支与master的差异
  DIFF=$(git diff master...HEAD --name-only)
  if [ -z "$DIFF" ]; then
      echo "❌ 该分支内容已合并到master，禁止推送！"
      exit 1
  fi
  exit 0
  

• 将脚本放到本地仓库的.git/hooks/pre-push，赋予执行权限chmod +x .git/hooks/pre-push，这样推送时就会自动拦截已合并的分支。

这些方案组合起来用，基本能覆盖你遇到的场景，我们团队在分布式多人开发的项目里一直这么执行，有效减少了分支混乱和误推送的问题。

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