如何解决 Git 冲突：refusing to merge unrelated histories¶

一、问题原因¶

当使用 git merge 命令合并分支时，如果 Git 检测到两个分支之间存在不相关的提交历史记录，即两个分支没有共同的祖先提交，Git 会拒绝合并并抛出以下错误：

refusing to merge unrelated histories

这种情况通常发生在： - 从零开始创建新仓库后，尝试合并另一个独立仓库的代码 - 本地仓库和远程仓库初始化方式不同 - 两个仓库的提交历史没有交集

二、解决方案¶

2.1 强制合并¶

使用 git merge 命令时，加上 --allow-unrelated-histories 选项来允许合并不相关的历史记录。

git merge --allow-unrelated-histories branch_name

示例：

# 切换到主分支
git checkout main

# 合并目标分支，允许合并不相关历史
git merge --allow-unrelated-histories feature-branch

注意： - 这种方法可能会导致合并后的历史记录变得混乱 - 在合并之前最好确认一下两个分支的内容 - 合并后可能会产生冲突，需要手动解决

2.2 使用 rebase¶

使用 git rebase 命令将当前分支的提交放在要合并的分支之前。

# 切换到目标分支
git checkout feature-branch

# 执行 rebase
git rebase main

# 切换回主分支
git checkout main

# 执行合并
git merge feature-branch

优点： - 可以保持提交历史的线性清晰 - 避免产生合并提交

缺点： - 会改变提交历史 - 如果分支有多个提交，可能需要处理更多冲突

2.3 手动合并¶

如果确定要将两个不相关的分支合并，可以使用手动合并的方式。首先切换到当前分支，然后使用 git cherry-pick 命令将要合并的分支中的提交逐个应用到当前分支。

# 切换到当前分支
git checkout main

# 逐个 cherry-pick 提交
git cherry-pick commit1
git cherry-pick commit2
git cherry-pick commit3
# ... 继续 cherry-pick 其他提交

# 提交更改
git commit

适用场景： - 只需要合并部分提交 - 想要精确控制合并哪些代码

三、注意事项¶

提前备份：在进行合并操作之前，建议备份当前分支的代码
确认内容：应该在合并之前确认要合并的分支内容，了解两个分支的差异
测试验证：合并后进行适当的测试，确保代码功能正常
沟通协作：如果是团队协作，合并前与团队成员沟通

查看差异：合并前可以先查看分支差异

git log main..feature-branch
git diff main...feature-branch