Git撤回已提交代码且保留本地改动的解决方案：含push后的情况处理

Git开发中误提交代码是常见问题，本文教你如何撤回push记录但保留本地改动。

许多开发者会遇到这种情况：刚完成commit操作并push到远程仓库，突然意识到这次提交存在问题。更棘手的是，这些代码仍需保留在本地继续修改。

本文将重点解决：

如何从版本历史中移除错误提交，同时确保本地修改得以保留

特别注意：此方法仅适用于独立开发场景，团队协作时慎用！！！

先说人话版结论

适用于以下场景：

1. 刚完成push操作
2. 需要撤销最近一次提交
3. 仍需保留代码修改

只需执行两条命令：

git reset HEAD~1
git push --force-with-lease origin main

执行效果：

1. 远程仓库移除该提交
2. 本地提交记录消失
3. 代码转为未提交状态

大多数情况下，这个方法就能解决问题。

命令原理详解

第一条命令

git reset HEAD~1

该命令的作用是：

将当前分支回退到上一个提交节点

需要注意：

1. 不会删除代码文件
2. 将commit内容还原为工作区修改

执行后可见：

1. 所有文件保留
2. 状态变为"未提交"

第二条命令

git push --force-with-lease origin main

实现功能：

用本地main分支覆盖远程main分支

本质是将回退后的状态同步至远程仓库。

精确控制版本回退方案

部分开发者偏好明确指定目标commit，而非简单回退一步。

关键点在于：

需要确定要回退到的具体提交版本。

第一步：查询commit id

基础查询命令：

git log --oneline

示例输出：

070505c github page   ← 需撤销的提交
ff775f6 first commit  ← 目标回退点

关键提示：需要记录的是目标提交的id。

可视化查看命令：

git log --oneline --graph --decorate -5

第二步：本地回退到指定版本

git reset --mixed ff775f6

执行效果：

1. 提交记录回退
2. 代码保留
3. 修改不在暂存区

如需保留暂存区状态：

git reset --soft ff775f6

第三步：强制更新远程仓库

git push --force-with-lease origin ff775f6:main

命令含义：

将远程main分支指向ff775f6提交

操作结果说明

1. 远程仓库移除错误提交
2. 本地提交历史清理
3. 代码修改保留在本地

这正是开发者需要的"撤销提交但保留修改"效果。

三段式写法的适用场景

部分教程推荐以下方案：

git reset --hard 
git push --force-with-lease origin :main
git cherry-pick --no-commit <某个提交>

这种方法属于补救措施，常规场景无需使用。

典型使用场景：

1. 已执行hard reset清除代码
2. 需恢复特定提交内容

对于刚提交就发现错误的情况，无需如此复杂。

为什么不推荐git revert

常见建议命令：

git revert

但其工作原理是：

创建反向提交记录

这意味着：

1. 原错误提交仍然存在
2. 仅新增撤销提交

若目标是彻底清除提交记录，则不应使用revert。

操作风险评估

需要明确的是，此操作存在一定风险。

关键风险命令：

git push --force-with-lease

这属于版本历史改写操作。

风险一：覆盖他人提交

若在push之前：

其他开发者已向main分支提交代码，强制推送可能覆盖这些提交。

风险二：破坏他人本地仓库

操作后可能造成：

1. 他人本地保留旧历史
2. pull/push操作冲突
3. 被删除的提交重新出现

安全操作建议

降低风险的实用建议：

1. 避免在多人分支操作

特别是多人协作的main分支。

2. 必须使用的安全命令

git push --force-with-lease

优于以下危险命令：

git push --force

前者会检查远端变更情况。

3. 操作前检查远端状态

git fetch origin
git log --oneline --graph --decorate --all -10

4. 已共享的提交勿修改历史

此时建议改用：

git revert

简化记忆方案

针对"刚push需撤回但保留代码"的场景：

git reset HEAD~1
git push --force-with-lease origin main

如需精确控制回退版本：

git log --oneline
git reset --mixed 
git push --force-with-lease origin :main

核心要点总结

Git版本控制的精髓在于：

删除的是提交记录而非代码内容。

掌握这一原则，Git操作将事半功倍。