如何解决Git分支合并时父目录与子文件的重命名冲突？

这个场景确实是Git重命名识别机制的一个盲区——因为Git只追踪文件的内容和路径，当两个分支分别修改了父目录路径和子文件路径，且文件内容完全没变时，Git没法自动关联这两个独立的重命名操作，导致合并冲突。下面提供两种可靠的解决方法：

方法一：直接在合并冲突中手动修正 #

这种方法适合不想修改原分支历史的情况：

1. 切换到目标分支secondBranch：

git checkout secondBranch

2. 尝试合并firstBranch，此时Git会触发冲突（因为它找不到firstBranch中重命名操作的源文件路径）：

git merge firstBranch

3. 手动完成文件重命名映射：
   在secondBranch中，原文件已经位于重命名后的目录frontends/myfrontend2/utils/下，我们需要把它重命名为myfile2.js：

git mv frontends/myfrontend2/utils/myfile.js frontends/myfrontend2/utils/myfile2.js

4. 清理冲突标记并完成合并：
   告诉Git我们已经解决了冲突，移除旧路径的缓存引用，然后提交合并结果：

# 追踪新命名的文件
git add frontends/myfrontend2/utils/myfile2.js
# 移除Git对旧路径的无效追踪
git rm --cached frontends/myfrontend/utils/myfile.js
# 提交合并
git commit

提交时可以自定义信息，比如"Merge firstBranch: preserve directory and file rename changes"。

方法二：先调整分支路径再合并（更优雅） #

如果允许修改firstBranch的历史（或创建临时调整分支），可以先让两个分支的路径结构对齐，再实现无冲突合并：

1. 切换到firstBranch：

git checkout firstBranch

2. 同步secondBranch的目录重命名操作：
   把firstBranch中的目录也重命名为myfrontend2，这样文件路径就和secondBranch对齐了：

git mv frontends/myfrontend frontends/myfrontend2

3. 提交路径调整：

git commit -m "Adjust directory structure to match secondBranch"

4. 切换回secondBranch并合并：

git checkout secondBranch
git merge firstBranch

此时Git会自动识别到文件的重命名操作，因为路径结构已经一致，不会触发冲突。

为什么会出现这个问题？ #

Git的find-renames和rename-threshold机制是通过文件内容相似度来识别重命名的，但这个场景下文件内容完全没有变化——冲突的根源是两个分支修改了文件路径的不同层级，Git无法自动推断出“子文件的重命名应该映射到父目录重命名后的新路径”，必须通过手动干预来关联这两个操作。

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