重命名Git子树目录后，如何合并远程仓库的提交？

方法一：用git subtree pull指定祖先提交+路径映射 #

说白了就是Git subtree认不出重命名后的路径，找不到历史关联。试试手动指定当初加子树的那个提交（D0），再配合路径参数拉取：

1. 先找到D0的哈希值——就是你第一次执行git subtree add生成的提交，搜提交日志里的Add 'some/dir1' as a subtree就能找到。
2. 执行下面的拉取命令，强制关联历史：

git subtree pull -P some/dir2 oldrepo dev --squash --strategy-option=subtree --allow-unrelated-histories -Xsubtree=some/dir1

要是还报错，就先把oldrepo的提交路径改成新目录再合并：

# 把oldrepo的dev分支拉到本地临时分支
git fetch oldrepo dev:temp-old-dev
# 切换到临时分支，把所有文件移到some/dir2路径下
git checkout temp-old-dev
git filter-repo --to-subdirectory-filter some/dir2
# 切回主分支，合并这个调整后的临时分支
git checkout main
git merge temp-old-dev --allow-unrelated-histories
# 用完删临时分支
git branch -D temp-old-dev

方法二：修复Git subtree的历史关联（长期可用） #

想以后正常用git subtree命令，就得让Git知道重命名前后的路径是同一个子树：

1. 找到你执行重命名的那个提交C2的哈希值（就是mv some/dir1 some/dir2的那次提交）。
2. 用git replace修改初始提交的路径映射：

# 切到初始子树提交D0，把路径改成some/dir2
git checkout D0
git mv some/dir1 some/dir2
git commit --amend --no-edit
# 切回主分支，用修改后的提交替换原来的D0
git checkout main
git replace D0 HEAD@{1}
# 现在再拉取就正常了
git subtree pull -P some/dir2 oldrepo dev

注意：git replace是本地修改，要是团队其他人也需要用，得把替换记录推上去：git push origin refs/replace/D0。

方法三：手动打补丁合并（临时救急） #

要是只是合一次，不想折腾历史，直接提补丁更省事：

1. 拉取oldrepo的最新代码：

git fetch oldrepo dev

2. 生成从初始提交C0到最新HEAD的差异补丁，把路径改成some/dir2：

git diff C0 oldrepo/dev > oldrepo-changes.patch
sed -i 's/^diff --git a\//diff --git a\/some\/dir2\//g' oldrepo-changes.patch
sed -i 's/^--- a\//--- a\/some\/dir2\//g' oldrepo-changes.patch
sed -i 's/^+++ b\//+++ b\/some\/dir2\//g' oldrepo-changes.patch

3. 把补丁应用到当前仓库，解决冲突后提交：

git apply oldrepo-changes.patch
# 检查some/dir2里的冲突，手动改完后提交
git add some/dir2
git commit -m "合并oldrepo dev分支的变更到some/dir2"

问题根源 #

Git subtree是靠路径匹配识别子树历史的，你把目录重命名后，路径变了，它就找不到当初加子树的那个提交D0了。不管是调整提交路径、指定祖先提交还是手动改补丁路径，核心都是让Git重新把oldrepo的历史和newrepo里的新路径关联起来。

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