合并两个Git仓库：解决非规范衍生仓库的上游更新痛点

我完全懂你这种手动diff解决差异的痛苦——每次更新都要对着文件挨个比对，既耗时又容易出错。咱们来把这个问题彻底解决掉，让后续的上游更新变得像常规Git操作一样简单。

首先得明确问题根源：你的仓库一开始是直接复制上游文件创建的，没有保留上游的提交历史，所以Git没法识别两个仓库之间的关联，导致每次更新都只能手动处理。接下来的步骤会帮你把上游仓库正式关联进来，让Git自动帮你处理大部分合并工作。

步骤1：添加上游远程仓库 #

先给你的本地仓库添加上游开源项目的远程地址，这样Git就能获取到上游的所有提交历史了：

git remote add upstream <上游开源项目的Git仓库URL>

比如如果上游是GitHub上的仓库，URL可能是https://github.com/example/upstream-repo.git。

步骤2：获取上游的所有提交 #

执行fetch命令拉取上游仓库的所有分支和提交历史：

git fetch upstream

这一步只会把上游的历史下载到本地，不会影响你当前的代码。

步骤3：合并上游历史到你的分支 #

因为你的仓库和上游仓库没有共享的提交历史，所以需要用--allow-unrelated-histories参数来允许合并：

# 先切换到你的主分支（比如main或master）
git checkout main

# 合并上游的主分支到你的分支
git merge upstream/main --allow-unrelated-histories

这时候Git会弹出冲突提示，你需要像平时处理合并冲突一样，编辑冲突文件，保留你的自定义修改和上游的更新，然后：

# 标记冲突文件已解决
git add <冲突文件名>

# 完成合并提交
git commit

步骤4：后续的上游更新就简单了 #

以后每次需要同步上游的更新时，只需要执行：

# 拉取上游最新提交
git fetch upstream

# 合并到你的分支
git merge upstream/main

Git会自动对比差异，只需要处理真正的冲突（如果有的话），再也不用手动复制文件和diff了！

重要注意事项 #

• 先备份分支：在执行合并操作前，建议先创建一个备份分支，防止操作失误丢失代码：

  git checkout -b backup-main
  

• 仔细解决冲突：合并时的冲突一定要仔细核对，确保你的自定义修改没有被覆盖，同时也保留了上游的重要更新。
• 可选：用Rebase代替Merge：如果你更喜欢线性的提交历史，可以用git rebase upstream/main代替git merge，不过rebase会改写提交历史，团队协作时要谨慎使用。

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