Git subtree pull报错：fatal: refusing to merge unrelated histories 解决方案咨询

嘿，这个问题我之前也碰到过！用git subtree关联独立仓库时，最容易踩“无关历史合并”的坑，--squash只是权宜之计，长期用肯定会乱。给你两个靠谱的解决方案：

一、还没执行--squash？直接修复首次同步 #

Git本身提供了允许合并无关联历史的参数，你只需要在第一次pull时加上它，就能彻底解决后续同步问题：

git subtree pull --prefix=foo st develop --allow-unrelated-histories

这个参数会告诉Git：“我清楚这两个分支没有共同祖先，允许合并它们”。执行完这次合并后，主仓库和子仓库的提交历史就建立了关联，后续同步子仓库变更时，直接用正常命令即可：

git subtree pull --prefix=foo st develop

二、已经用--squash合并过？重置历史重新关联 #

如果已经用--squash做了一次合并，本地foo目录的历史已经和子仓库真实历史脱节，这时候最好重置历史，重新建立正确关联：

1. 先备份当前foo目录（防止丢失本地修改）：

cp -r foo foo_backup

2. 找到并回滚之前的squash提交：用git log查看提交记录，找到对应squash合并的commit hash，执行回滚：

git revert <你找到的squash提交hash>

3. 删除本地foo目录：

rm -rf foo

4. 重新添加子仓库并完成首次关联同步：

git subtree add --prefix=foo st develop
git subtree pull --prefix=foo st develop --allow-unrelated-histories

做完这些步骤，主仓库和子仓库的历史就完全关联了，后续正常pull同步即可。

小提醒：Git Subtree的日常最佳实践 #

• 首次添加子仓库时，确保--prefix指定的本地目录是空的，避免初始合并冲突；
• 如果本地目录已有内容，建议先把这些内容迁移到子仓库后再关联，这样提交历史会更清晰；
• 日常同步尽量不用--squash，除非你明确不需要保留子仓库的完整提交历史。

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