本文介绍了 Git 代码撤回的两种主要场景及解决方案。对于已提交未推送的代码，推荐使用 git reset 命令（如 --soft 保留更改），灵活撤销本地提交。对于已提交且已推送的代码，团队协作分支应使用 git revert 创建新提交以撤销变更，确保历史完整且安全；个人分支可谨慎使用 git reset 配合强制推送改写历史。操作前需备份，主分支禁止强制推送。掌握 reflog 可恢复误操作，遵循规范提交和分支保护策略能降低风险。
在日常开发中，我们经常会遇到需要撤回代码的情况。本文将详细介绍两种常见场景的解决方案：已提交未推送的代码撤回，以及已提交已推送的代码撤回。
代码已经通过 git commit 提交到本地仓库，但还没有 git push 到远程仓库。这时想要撤回这次提交。
使用 git reset --soft 可以撤销提交，但保留所有更改在暂存区：
# 撤销最近一次提交，保留更改在暂存区
git reset --soft HEAD~1
效果：
查看当前状态：
git status
使用 git reset --mixed（或简写为 git reset）：
# 撤销最近一次提交，更改保留在工作区但不在暂存区
git reset HEAD~1
效果：
git add）使用 git reset --hard，慎用：
# ⚠️ 警告：此操作会永久删除所有更改
git reset --hard HEAD~1
效果：
如果要撤销最近 N 次提交：
# 撤销最近 3 次提交（保留更改）
git reset --soft HEAD~3
# 撤销最近 2 次提交（删除更改）
git reset --hard HEAD~2
git restore --staged <文件名>
# 取消所有文件的暂存
git restore --staged .
git restore <文件名>
代码已经通过 git commit 提交并通过 git push 推送到远程仓库。现在需要撤回这次提交。
| 方案 | 安全性 | 适用场景 | 历史记录 |
|---|---|---|---|
| git revert | ✅ 安全 | 团队协作、主分支 | 保留完整历史 |
| git reset + force push | ⚠️ 危险 | 个人分支 | 改写历史 |
原理： 创建一个新的提交来撤销之前的更改，不改变提交历史。
# 撤销最近一次提交
git revert HEAD
# 撤销指定的提交（使用提交哈希）
git revert <commit-hash>
# 自动使用默认提交信息（无需编辑器）
git revert HEAD --no-edit
1. 查看提交历史
git log --oneline -5
输出示例：
963e69b Revert "前端报错问题" 88956dc Merge branch 'frontend' e9f4a9b 前端报错问题 e239e05 bug 修复 4c90d19 修改初始状态的布局
2. 撤销指定提交
# 撤销 e9f4a9b 这个提交
git revert e9f4a9b --no-edit
3. 推送到远程
git push
如果工作区有未提交的更改，revert 会失败：
错误信息 error: Your local changes would be overwritten by merge Please commit your changes or stash them before you merge.
解决方法：暂存当前更改
# 1. 暂存当前更改
git stash
# 2. 执行 revert
git revert <commit-hash> --no-edit
# 3. 推送到远程
git push
# 4. 恢复之前暂存的更改
git stash pop
# 撤销从 commit1 到 commit3 的所有提交（不包含 commit1）
git revert commit1..commit3
# 撤销多个不连续的提交
git revert commit1 commit2 commit3
原理： 直接回退到之前的提交并强制推送，改写远程历史。
# 1. 回退到上一个提交
git reset --hard HEAD~1
# 2. 强制推送到远程（⚠️ 危险操作）
git push --force
# 查看提交历史
git log --oneline
# 回退到指定提交
git reset --hard <commit-hash>
# 强制推送
git push --force
# 更安全的强制推送，避免覆盖他人的提交
git push --force-with-lease
严重后果：
禁止场景：
允许场景：
决策树：
代码是否已推送？ ├─ 否 → 使用 git reset --soft HEAD~1 └─ 是 → 继续判断 ├─ 是否团队协作分支？ │ ├─ 是 → 使用 git revert（必须） │ └─ 否 → 继续判断 │ └─ 其他人是否拉取过？ │ ├─ 是 → 使用 git revert │ └─ 否 → 可以使用 git reset + force push
| 模式 | 命令 | 提交历史 | 暂存区 | 工作区 |
|---|---|---|---|---|
| soft | git reset --soft HEAD~1 | 撤销 ✓ | 保留 ✓ | 保留 ✓ |
| mixed | git reset HEAD~1 | 撤销 ✓ | 清空 ✗ | 保留 ✓ |
| hard | git reset --hard HEAD~1 | 撤销 ✓ | 清空 ✗ | 清空 ✗ |
如果不小心执行了 git reset --hard，可以使用 reflog 恢复：
# 查看所有操作历史
git reflog
# 找到误操作前的提交哈希，然后恢复
git reset --hard <commit-hash>
# 如果是最近的 merge
git revert -m 1 HEAD
# 如果是指定的 merge 提交
git revert -m 1<merge-commit-hash>
使用 revert 后，团队成员只需：
git pull
如果使用了 force push，团队成员需要：
# 1. 备份本地更改
git stash
# 2. 强制同步远程（会丢失本地提交）
git fetch origin
git reset --hard origin/<branch-name>
# 3. 恢复本地更改
git stash pop
场景： 刚刚提交了一个不该提交的代码，但还未推送。
# 1. 撤回提交，保留更改
git reset --soft HEAD~1
# 2. 查看状态
git status
# 3. 取消不需要的文件暂存
git restore --staged <不需要的文件>
# 4. 重新提交需要的文件
git add <需要的文件>
git commit -m "正确的提交信息"
# 5. 推送
git push
场景： 推送了错误的代码到团队分支，需要撤回。
# 1. 暂存本地更改（如果有）
git stash
# 2. 撤销指定提交
git log --oneline -5
# 找到要撤销的提交哈希
git revert e9f4a9b --no-edit
# 3. 推送
git push
# 4. 恢复本地更改
git stash pop
# 5. 通知团队成员
# 团队成员只需执行：git pull
场景： 在个人特性分支上推送了错误代码，确认无人使用。
# 1. 回退到上一个提交
git reset --hard HEAD~1
# 2. 强制推送（确认是个人分支）
git push --force-with-lease
# 注意：团队成员如果拉取过此分支会遇到冲突
# 查看将要提交的更改
git diff --staged
# 查看状态
git status
创建 .git/hooks/pre-commit 文件，在提交前自动检查：
#!/bin/sh
# 检查是否包含敏感信息
if git diff --cached | grep -i "password\|secret\|key"; then
echo "⚠️ 检测到敏感信息，提交已阻止！"
exit 1
fi
# 使用规范的提交信息格式
git commit -m "feat: 添加用户登录功能"
git commit -m "fix: 修复实体详情报错问题"
git commit -m "refactor: 重构图表组件"
| 场景 | 推荐方案 | 命令 | 风险等级 |
|---|---|---|---|
| 已提交未推送 | git reset --soft | git reset --soft HEAD~1 | 🟢 低 |
| 已推送（团队） | git revert | git revert <hash> --no-edit && git push | 🟢 低 |
| 已推送（个人） | git reset + force | git reset --hard HEAD~1 && git push --force | 🔴 高 |
核心原则：
git revert，安全可靠git reset，灵活方便git push --force，确认无人使用--force
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML 转 Markdown 互为补充。 在线工具，Markdown 转 HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML 转 Markdown在线工具，online
通过删除不必要的空白来缩小和压缩JSON。 在线工具，JSON 压缩在线工具，online
将JSON字符串修饰为友好的可读格式。 在线工具，JSON美化和格式化在线工具，online