Git移动目录后合并特性分支新文件丢失历史的原因及规避方法

• Git的文件历史追踪逻辑是基于提交链中的路径关联+内容相似度回溯的，并不会给单个文件绑定独立的唯一标识。本次合并丢失历史的核心是没有让Git建立新路径下test4.py和feature分支旧路径下test4.py的关联。
• 具体场景下，main分支已经将dir1/python1/整体迁移到了dir2/python1/，而feature分支的test4.py仅存在于已被main分支删除的dir1/python1/路径下。使用ort合并策略时，Git默认不会主动为仅在单侧分支存在的文件做路径映射，只会提示原路径不存在的冲突。
• 如果解决冲突时直接手动将test4.py的内容复制到新路径dir2/python1/下再提交合并，Git会判定新路径的test4.py是合并提交时新增的文件，不会关联feature分支上旧路径文件的提交历史，最终表现就是历史全部丢失。

• 优先在合并前对齐feature分支目录结构：先将feature分支rebase到最新的main分支，rebase过程中Git会自动识别main分支的目录移动操作，将dir1/python1/test4.py自动迁移到dir2/python1/test4.py，后续合并不会产生冲突，提交历史也会完整保留。
• 解决冲突时用git mv明确移动关系：如果已经触发合并冲突，不要手动复制文件内容，执行git mv dir1/python1/test4.py dir2/python1/test4.py告知Git该文件的路径变更关系，再完成合并提交，Git就能正确关联文件的历史记录。
• 合并时调高重命名检测灵敏度：执行合并命令时添加参数-X find-renames=<相似度阈值>，例如git merge -s ort -X find-renames=90，提高Git对路径移动、文件重命名的检测灵敏度，尽可能让Git自动识别单侧文件的路径映射关系，减少手动处理的冲突。

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