Git跨仓库分支迁移及解决“无关历史”合并失败的最优方案

核心原因 #

出现fatal: refusing to merge unrelated histories是因为repo2的分支与repo1的分支没有共同提交历史，Git默认禁止合并无关联的分支。我们需要先让两个仓库的分支建立历史关联，再完成同步与合并操作。

步骤1：为repo2添加repo1作为远程源 #

在repo2的本地仓库终端中执行：

git remote add repo1 <repo1的Git仓库URL>

若后续需更新远程地址，可执行：

git remote set-url repo1 <新的仓库URL>

步骤2：同步repo2的develop分支到repo1的app-dev #

切换到develop分支：

git checkout develop

第一次拉取repo1的app-dev内容时，需允许合并无关历史：

git pull repo1 app-dev --allow-unrelated-histories

手动解决可能出现的文件冲突后，提交合并结果：

git add .
git commit -m "同步repo1/app-dev初始内容，建立关联历史"

后续日常同步只需执行：

git pull repo1 app-dev

步骤3：同步repo2的release/v1.0.0分支到repo1的app-prod #

切换到release分支：

git checkout release/v1.0.0

第一次拉取时允许合并无关历史：

git pull repo1 app-prod --allow-unrelated-histories

解决冲突后提交：

git add .
git commit -m "同步repo1/app-prod初始内容，建立关联历史"

后续日常同步执行：

git pull repo1 app-prod

步骤4：将release/v1.0.0合并回develop分支 #

此时两个分支已拥有共同的历史基础（来自repo1的提交），直接执行合并：

git checkout develop
git merge release/v1.0.0

若出现冲突，解决后提交合并结果：

git add .
git commit -m "合并release/v1.0.0到develop"

后续维护建议 #

• 定期同步：develop分支定期拉取repo1/app-dev，release分支定期拉取repo1/app-prod，避免冲突积累。
• 合并前置检查：合并release到develop前，先确保release已同步最新的repo1/app-prod内容，同时develop也同步了最新的repo1/app-dev，降低冲突概率。

内容的提问来源于stack exchange，提问作者m-ketan