迁移ES5至ES6时修改文件路径，如何保留Git文件历史？

核心原因 #

Git通过内容相似度识别文件重命名。你在移动file.js后立刻进行了ES5转ES6的大量修改，内容变化幅度过大，Git无法关联旧路径的原文件与新路径的修改后文件，因此被标记为删除+新建；而单元测试文件修改较少，Git能正确识别为移动操作。

推荐解决方案：拆分提交 #

把「文件移动」和「内容修改」拆成两个独立提交，让Git正确识别重命名：

1. 回退到刚完成文件移动但还未修改内容的提交（如果已经提交了移动+修改，先找到移动完成的提交哈希，执行git reset --hard <移动提交的哈希值>）
2. 单独提交文件移动操作：

   git add .
   git commit -m "refactor: 迁移file.js及测试文件至新路径"
   

3. 重新进行ES6语法迁移的修改，完成后单独提交内容变更：

   git add .
   git commit -m "refactor: 将file.js从ES5迁移至ES6"
   

4. 强制推送分支更新PR：

   git push -f origin <你的分支名>
   

备选方案（不推荐） #

如果不想拆分提交，可以手动让Git关联新旧文件的历史，但操作繁琐且需要团队同步：

1. 用git log path/to/file.js找到旧路径文件的最后一次提交哈希
2. 执行git replace --graft <当前新文件提交的哈希> <旧文件最后提交哈希>
3. 同步replace信息给团队成员，否则他们的Git仍会显示文件历史断裂

注意事项 #

• 移动文件后优先提交移动操作，再做内容修改，避免Git无法识别重命名
• 强制推送前要和团队成员沟通，避免覆盖他人的分支修改

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