多年运行项目中途搭建Git：SVN正式版导入Git定制仓的合并问题解决

问题根源 #

Git合并两个分支时，会以两者的**最近共同祖先（merge base）**为基准，分别计算两边相对于该基准的改动再完成合并。
如果按你设想的「从Marie的工作分支拉出Bob版本的导入分支→在导入分支上做对齐提交（把文件改成Bob纯官方版）」的流程操作，后续所有合并的共同祖先都会停留在拉导入分支时的工作分支提交，那次对齐提交的改动（也就是抹除Marie定制的操作）会一直被当成Bob分支的新增改动参与合并，导致反复冲突甚至覆盖Marie的定制内容。

最优解决方案：孤儿分支导入法 #

这个方案完全规避了初始对齐提交干扰后续合并的问题，操作步骤如下：

具体操作流程 #

• 第一步：创建专门存放Bob纯官方版本的孤儿分支
  孤儿分支没有关联任何现有历史，和Marie的工作分支完全独立，执行命令：

  # 先确保现有工作区没有未提交的改动，切换到任意分支都可执行
  git checkout --orphan upstream-bob
  # 清空当前工作区所有被Git跟踪的旧文件，避免残留Marie的定制内容
  git rm -rf .
  

• 第二步：导入Bob的第一个官方版本，完成初始提交
  把Bob发布的纯官方版本所有文件复制到当前工作区，提交到分支：

  git add -A
  git commit -m "导入Bob官方版本 v1.0"
  

  此时upstream-bob分支只有这一个独立提交，是完全独立的Bob v1.0纯版本快照。
• 第三步：第一次合并Bob版本到Marie的日常工作分支
  切回Marie的日常工作分支（比如命名为main），因为两个分支没有共同历史，需要额外允许合并无关联历史的参数：

  git checkout main
  git merge upstream-bob --allow-unrelated-histories -m "合并Bob官方v1.0到工作分支"
  

  弹出冲突处理界面后，手动保留Marie已有的定制修改，同时合并Bob版本的新增/非定制改动，完成提交即可。
• 后续每次Bob发布新版本的复用流程
  每次拿到Bob的新版本后，重复以下操作即可：

  # 切回Bob版本导入分支
  git checkout upstream-bob
  # 清空所有旧的官方版本文件，确保和Bob新版本完全对齐
  git rm -rf .
  # 复制Bob的新版本文件到工作区
  git add -A
  git commit -m "导入Bob官方版本 vX.Y"
  # 切回Marie的日常工作分支，直接合并即可，不需要额外参数
  git checkout main
  git merge upstream-bob -m "合并Bob官方vX.Y到工作分支"
  

方案的核心优势 #

• 后续每次合并upstream-bob到工作分支时，Git找到的最近共同祖先就是上一次导入的Bob官方版本提交，只会计算Bob在上一个版本到当前新版本之间的改动，以及Marie的定制改动来合并，初始的对齐提交就是第一个Bob版本本身，已经是合并基准，不会被当成额外改动参与计算。
• upstream-bob分支全程只存放Bob的纯官方版本，不要在这个分支上做任何Marie的定制修改，保证其历史只有纯官方版本的线性提交，不会引入额外干扰。

注意事项 #

• 每次导入Bob新版本前，执行完git rm -rf .后，可手动检查工作区是否有未被Git跟踪的残留文件，全部删除后再导入Bob的新版本，避免多余文件干扰版本对齐。
• 如果后续需要把Marie的修改回传给Bob，只需要从Marie的工作分支拉出回传分支，提取需要回传的改动即可，不会影响上述版本同步流程。

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