修复删除后重建文件的Git历史断层问题

前置准备 #

• 确保当前在迁移分支上，所有修改都已提交，没有未暂存/未提交内容
• 先备份分支防翻车：git branch backup-migrate

具体操作步骤 #

1. 定位关键提交
   运行git log --oneline查看提交记录，找到那个删除大量/lib文件、替换成Hello World界面的提交哈希（比如abc123），同时记下它的前一个提交哈希（比如def456，也就是删除操作前最后一个正常提交）。

2. 进入交互式变基模式
   执行命令：

   git rebase -i def456
   

   编辑器会弹出提交列表，找到删除/lib文件的那一行，把开头的pick改成edit，保存退出。

3. 撤销/lib文件的删除操作
   此时Git会停在那个删除提交的节点，执行命令恢复删除前的/lib文件：

   git restore --source=def456 -- lib/
   

   如果当时添加的Hello World虚拟文件已经没用了，直接删掉这些文件，然后重新修改这个提交：

   git commit --amend --no-edit
   

   这一步会把原来的“删除/lib文件”提交，改成“保留原/lib文件+（可选）添加Hello World界面”的提交。

4. 完成变基
   执行命令继续变基流程：

   git rebase --continue
   

   Git会自动应用后续所有提交，包括你恢复原文件、迁移代码的操作。这时候后续提交里的文件修改会被Git识别为对原有文件的更新，而非新增文件，历史断层就消失了。

5. 处理冲突（若有）
   变基时如果出现冲突，手动解决冲突后，执行git add <冲突文件名>，再运行git rebase --continue即可。

额外提示 #

• 如果后续恢复/lib文件的提交只是单纯把原文件加回来，变基后这个提交会被Git自动合并，无需额外处理
• 变基修改了历史记录，如果分支已经推送到远程，需要强制推送：git push -f，但要提前和团队成员沟通，避免同步冲突

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