Git从upstream拉取时报refusing to merge unrelated histories错误如何解决？
2026-10-2
Git拉取合并冲突解决方案
错误原因
- 出现
fatal: refusing to merge unrelated histories报错，是因为本地仓库和目标拉取仓库没有共同提交历史，属于两个独立的Git项目，Git默认拒绝无关联合并。 - 加
--allow-unrelated-histories参数后触发Automatic merge failed; fix conflicts and then commit the result提示，是因为两个分支的相同文件存在内容差异，Git无法自动完成合并，需要手动处理冲突。
解决步骤
- 查看冲突文件列表
运行命令git status，输出中标记为both modified的文件就是存在冲突的文件。 - 手动处理冲突
打开每个冲突文件，文件内会用分隔符标记不同分支的内容：
<<<<<<< HEAD 这部分是你本地分支的对应内容 ======= 这部分是拉取的上游分支的对应内容 >>>>>>> upstream/branch
根据实际需求编辑文件：可以保留本地内容、保留上游内容，也可以整合两部分内容，编辑完成后删除所有<<<<<<<、=======、>>>>>>>分隔标记。
3. 标记冲突已解决
所有冲突文件编辑完成后，执行git add <冲突文件路径>，如果所有冲突都处理完毕也可以直接运行git add .批量标记。
4. 提交合并结果
执行git commit，Git会自动生成合并提交说明，直接保存退出即可，也可以使用git commit -m "自定义合并说明"来提交。
5. 同步到远程仓库（可选）
如果需要把合并后的内容推送到自己的origin远程仓库，执行git push origin <本地分支名>即可。
快速处理方案（无需手动编辑文件）
如果不需要手动整合内容，可以直接选择保留某一端的内容覆盖另一端：
- 全部保留本地内容，丢弃上游分支的冲突内容：
git checkout --ours <冲突文件路径> - 全部保留上游分支内容，覆盖本地的冲突内容：
git checkout --theirs <冲突文件路径>
执行完上述命令后，再走add、commit的流程即可完成合并。
内容的提问来源于stack exchange，提问作者Alex mercer
相关产品推荐
相关产品推荐
