Git合并含文件重命名分支时冲突的原因及解决方法咨询

为什么会触发冲突？ #

Git并不直接存储“文件重命名”这个操作——git mv foo foo.moved本质是删除原文件foo + 添加新文件foo.moved的组合，提交时Git只是通过对比文件内容的相似度，识别出这是一次重命名操作并在日志里显示。

当你在两个分支分别做了以下操作：

• moved分支：删除foo、添加foo.moved（即重命名）
• main分支：修改foo
  合并时Git的默认逻辑会判定为HEAD（moved）删除了foo，而main修改了foo，无法自动关联foo的修改和foo.moved，因此触发modify/delete冲突。

解决方法 #

方法1：手动处理冲突 #

合并冲突后按以下步骤操作：

1. 查看当前文件：此时目录里会有foo（来自main分支的修改版）和foo.moved（来自moved分支的重命名文件）
2. 把foo中的修改内容合并到foo.moved里（可以手动编辑，或者用命令快速合并）：

   cat foo >> foo.moved
   

3. 删除多余的foo文件：

   git rm foo
   

4. 提交合并结果：

   git add foo.moved
   git commit
   

方法2：利用Git重命名检测参数自动合并 #

Git合并时可以通过-X rename-threshold参数调整重命名识别的内容相似度阈值（默认是50%），因为这里原文件只是添加了一行内容，相似度极高，只要把阈值调低就能让Git自动关联：

git merge main -X rename-threshold=10%

执行后Git会自动把main分支对foo的修改应用到foo.moved上，完成无冲突合并。

如果是用rebase操作，同样可以添加该参数：

git rebase main -X rename-threshold=10%

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