如何合并release分支到main：解决冲突并保持Git历史整洁

问题本质 #

你遇到的核心问题是频繁使用--squash合并破坏了分支间的历史关联：每次squash合并都会丢弃原分支的提交历史，导致main和development无法找到有效的共同祖先。Git在合并时会默认从最早的差异点开始对比，最终把数百个提交都视为新变更，引发大量冲突和冗余提交。

方案一：彻底重写历史（根治问题，需团队协调） #

这种方案会重置development的历史，建立和main的正确关联，适合能协调团队同步分支的场景：

1. 找到最后一次共享的有效提交
   运行以下命令查看分支历史，找到main和development最后一次真正合并（非squash）的提交哈希值，记为<common-sha>：

   git log --oneline --graph main development
   

2. 创建干净的新开发分支
   基于共享提交新建分支，作为新的development：

   git checkout -b development-new <common-sha>
   

3. 合并当前开发分支的所有变更
   将旧development的所有变更一次性 squash 到新分支，只保留一个汇总提交：

   git merge --squash development
   # 解决所有冲突（仅需一次）
   git commit -m "Sync all development changes up to [版本/日期]"
   

4. 替换旧分支并推送
   替换远程的development分支（需提前告知团队，避免冲突）：

   git branch -m development development-old
   git branch -m development-new development
   git push -f origin development
   

   让所有团队成员执行：

   git fetch origin
   git checkout development
   git reset --hard origin/development
   

5. 调整后续工作流

   • 合并feature/*到development时，可继续用squash（如果需要整理提交），但合并release/*到main和development时必须用普通合并：

     # 合并release到main
     git checkout main
     git merge --no-ff release/xxx
     

   • 定期用普通合并同步main到development，维持历史关联。

方案二：不重写历史（妥协方案，适合无法强制推送的场景） #

如果不能修改远程分支历史，用以下方法解决当前问题并避免复发：

1. 处理当前release/*合并到main
   绕过冗余提交，直接把release的变更 squash 到main：

   git checkout main
   git merge --squash release/xxx
   # 解决冲突
   git commit -m "Merge release/xxx to main"
   

2. 建立main与development的历史关联
   用ours策略合并main到development，确保开发分支内容优先，同时让Git记录合并节点：

   git checkout development
   git merge -s ours main
   

   这次合并后，Git会识别两者的共同祖先，后续合并时不会再出现大量冗余提交。

3. 调整后续工作流

   • 合并release/*到main和development时，必须使用--no-ff普通合并，禁止用squash，维持分支历史关联。
   • 避免无意义的squash合并，仅在需要整理零散提交时使用。

关键注意事项 #

• 重写历史后，团队成员必须丢弃本地旧分支，重新拉取远程分支，否则会出现严重冲突。
• 核心原则：让main和development保持可追踪的历史关联，避免频繁用squash切断分支间的祖先关系。

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