Git撤回已Push的代码的方法大全

好的，撤回已经 Push 到远程仓库的代码是一个需要谨慎操作的过程，因为如果操作不当，可能会给协作者带来混乱。下面我将根据不同的场景，从简单到复杂，详细介绍 Git 撤回已 Push 代码的各种方法及最佳实践。

核心原则：安全第一

在执行任何撤回操作前，请牢记：

1. ​备份分支​：如果不确定，先创建一个备份分支 git checkout -b backup-branch。
2. ​沟通！沟通！沟通！​​：尤其是团队协作时，务必提前告知队友你将要进行强制推送，让他们做好应对准备（比如先 git pull 或 git fetch 再 git reset）。
3. ​考虑影响范围​：你的撤回会影响所有拉取了该分支的人。

---

方法一：彻底删除法（适用于撤销整个提交，且提交未合并到主分支）

这是最直接的方法，它会从历史中彻底删除指定的提交。​破坏性最强，请慎用！​​

​适用场景​：最新的几次提交是完全错误的，并且还没有其他人基于这些提交进行工作。

​步骤​：

1. ​找到要回退到的目标提交的哈希值（commit hash）​。
   使用 git log --oneline 查看提交历史，找到你想回退到的那个提交的哈希值（前7位即可），或者直接使用相对引用 HEAD~n（n代表回退几步）。 git log --oneline # 输出示例： # a1b2c3d (HEAD -> main, origin/main) 错误的提交C # e4f5g6h 错误的提交B # 789abc0 正确的提交A <-- 我们想回退到这里
2. ​本地重置到目标提交。
   使用 --hard 选项会让你的工作区和暂存区都完全回退到指定提交的状态，​请确保没有未提交的更改，否则会丢失。 git reset --hard 789abc0 # 或者 git reset --hard HEAD~2 （回退两步，跳过B和C）
3. ​强制推送到远程仓库。
   由于你改写了本地历史，与远程仓库产生了分歧，必须使用 --force（或更安全的 --force-with-lease）来强制覆盖远程分支。 git push origin main --force # 或者更安全的方式： git push origin main --force-with-lease ​**--force-with-lease 的优势**​：它会检查远程分支是否有你未知的新提交（比如队友在你重置后推送了新的代码），如果有，则拒绝强制推送，避免覆盖他人的工作。

​后果​：提交 B 和 C 将从分支历史中消失。所有协作者需要使用 git fetch origin 然后 git reset --hard origin/main 来同步这个“暴力”改动，否则他们的后续推送会非常麻烦。

---

方法二：温和撤销法（推荐用于公共分支）

这种方法不会删除历史提交，而是通过创建一个新的“撤销提交”来抵消之前的更改。​历史记录完整，是最安全的协作方式。​​

​适用场景​：绝大多数情况，尤其是已经推送到公共分支（如 main, develop）的提交。

2.1 使用 git revert（首选）

revert 会分析指定提交的更改，然后创建一个新的提交来反向抵消这些更改。

​步骤​：

1. ​找到要撤销的提交的哈希值。 git log --oneline # 假设我们要撤销 a1b2c3d 这个提交
2. ​执行撤销操作。 # 撤销单个提交 git revert a1b2c3d # 撤销多个连续提交（例如从 a1b2c3d 到 e4f5g6h，注意顺序） # 这会为每个要撤销的提交都生成一个独立的 revert commit git revert --no-commit a1b2c3d..e4f5g6h git commit -m "Revert commits a1b2c3d to e4f5g6h" 执行后，Git 会打开编辑器让你填写新生成的 revert 提交的说明信息，保存即可。
3. ​推送新的撤销提交。
   因为 revert 只是在本地创建了一个新提交，所以直接推送即可，无需强制推送。 git push origin main

​优点​：

• ​安全​：不修改历史，对协作者友好。
• ​可追溯​：历史记录清晰地展示了“做了什么”和“撤销了什么”。

​缺点​：

• 如果提交已经被其他分支合并，单纯的 revert 可能无法完全撤销其影响，需要更复杂的操作。

2.2 使用 git revert 撤销合并提交（特殊情况）

撤销一个合并提交（merge commit）比较复杂，因为它有多个父提交。你需要告诉 Git 你想回到哪个父提交的状态。

​步骤​：

1. 找到合并提交的哈希值。
2. 使用 -m 选项指定主线（parent）编号。-m 1 通常表示保留第一个父提交（即合并过来的分支）的历史主线。 git log --oneline --graph # 查看图形化历史，确认父提交顺序 git revert -m 1 <merge-commit-hash>
3. 推送：git push origin main

---

方法三：交互式变基法（高级用法，用于改写历史）

git rebase -i（交互式变基）可以让你像电影剪辑一样重新编排、合并、删除、修改提交。​这是一个强大的工具，但在已推送的分支上使用极具破坏性。​​

​适用场景​：需要精细地修改最近的一些提交（例如合并多个琐碎的提交、修改提交信息等），并且确定只有你一个人在使用该分支，或者已经和所有协作者协调好。

​步骤​：

1. ​启动交互式变基。 # 编辑最近3个提交 git rebase -i HEAD~3
2. ​在编辑器中标记要操作的提交。
   编辑器会列出最近的几个提交，格式如下： pick 789abc0 正确的提交A pick e4f5g6h 错误的提交B pick a1b2c3d 错误的提交C # Commands: # p, pick = use commit # r, reword = use commit, but edit the commit message # e, edit = use commit, but stop for amending # s, squash = use commit, but meld into previous commit # d, drop = remove commit
   • 要删除某个提交，将其行首的 pick 改为 drop，或者直接删除该行。
   • 要修改提交信息，改为 reword。
   • 要合并提交，改为 squash。
   例如，要删除提交 B 和 C： pick 789abc0 正确的提交A drop e4f5g6h 错误的提交B drop a1b2c3d 错误的提交C
3. ​保存退出编辑器，Git 会执行变基操作。
4. ​强制推送到远程。
   由于历史已被改写，必须强制推送。 git push origin main --force-with-lease

---

方法四：临时隐藏法（适用于尚未完成的工作）

如果你只是不小心 push 了一些未完成或临时的代码，并不想为此创建提交，可以使用 git stash。

​步骤​：

1. ​暂存当前更改。 git stash
2. ​强制推送到远程（如果需要清空已推送的提交）​。
   如果 stash 前你已经提交了，需要先 reset 再 stash，然后强制推送。如果只是 stash 了未提交的更改，远程可能并没有新东西，无需推送。如果远程已有你不想保留的提交，仍需使用方法一或三。
3. ​后续恢复工作。
   当你准备好时，可以随时恢复暂存的工作： git stash pop

---

总结与选择指南

方法	命令	适用场景	安全性	历史记录
​彻底删除法​	git reset --hard + git push --force	彻底丢弃最新私有提交	​低​（破坏协作）	改写，提交丢失
​温和撤销法​	git revert	​公共分支，撤销已推送的提交	​高​（推荐）	保留，新增撤销提交
​交互式变基​	git rebase -i + git push --force	精细修改近期提交历史	​极低​（高风险）	改写，提交被编辑/删除
​临时隐藏法​	git stash	暂存未提交的更改	​高​	不影响

​黄金法则​：

• ​公共分支（main, develop）​​：永远优先使用 git revert。
• ​私有特性分支​：如果分支只有你自己用，可以使用 git reset 和 --force 来保持历史整洁，但在合并前最后做一次 revert 或 reset 并强制推送。
• ​不确定时​：默认使用 git revert。