如何将其他仓库指定目录合并到本地仓库（目录路径不同）

方案一：临时分支转换路径后合并 #

通过临时分支调整对方仓库的目录结构，匹配本地路径后再合并，避免路径重叠冲突：

1. 添加对方仓库为远程（未添加时执行）

   git remote add upstream <对方仓库URL>
   git fetch upstream
   

2. 创建临时分支，仅拉取对方的目标目录

   git checkout -b temp-upstream-target upstream/main -- long/path/to/the/target
   

3. 调整临时分支的目录结构

   • 移除暂存区的无关文件：git rm -r . --cached
   • 将深层目录下的文件移动到分支根目录：git mv long/path/to/the/target/* .
   • 删除原深层空目录：git rm -r long/path/to/the/target
   • 提交结构调整：git add . && git commit -m "适配本地target目录结构"

4. 切换回本地主分支并合并

   git checkout main
   git merge temp-upstream-target --allow-unrelated-histories
   

   此时Git会自动对比target目录下的文件，正常处理file_1、file_2的冲突即可——保留你的修复修改，同时合并对方的更新和新增的file_3。

5. 清理临时分支

   git branch -D temp-upstream-target
   

方案二：git subtree长期管理（适合频繁同步） #

如果后续需要多次同步对方的target目录，推荐用git subtree工具：

1. 添加远程并拉取最新代码

   git remote add upstream <对方仓库URL>
   git fetch upstream
   

2. 将对方深层目录关联到本地target

   git subtree add --prefix=target upstream/main --squash -- long/path/to/the/target
   

   --squash会压缩对方的提交记录，避免本地提交历史过于繁杂。

3. 后续同步对方更新

   git subtree pull --prefix=target upstream/main --squash -- long/path/to/the/target
   

   同样会触发冲突解决流程，按需保留你的修改即可。

错误原因说明 #

你遇到的“entry 'file' overlaps with 'file'. Cannot bind”错误，是因为直接合并不同路径下的同名文件时，Git无法自动完成路径映射，导致索引中出现重复的文件条目。通过临时分支调整路径，或者用subtree指定明确的路径前缀，就能解决这个重叠问题。

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