Git 版本回退操作指南

一、核心概念

版本回退有两种方式：reset（指针回退）和 revert（新提交撤销）。选择哪种取决于你的场景。

	reset	revert
原理	HEAD 指针往前挪，后面的提交"消失"	生成一个新的提交来抵消目标提交的改动
是否改写历史	✅ 是	❌ 否
适合共享分支	❌ 不适合（push 需要用 -f）	✅ 适合
适合本地/私有分支	✅ 适合	✅ 也可以
回退后是否能找回	本地可找（reflog，90天）	提交历史完整保留
多人协作推荐	❌	✅

二、reset — 指针回退（改写历史）

2.1 三种模式（最重要）

reset 有三个模式，区别在于影响的范围不同：

参数	HEAD 指针	暂存区（Index）	工作区（本地文件）	典型场景
`--soft`	✅ 移动	❌ 不动	❌ 不动	修改 commit message 或重新组织 commit 内容
`--mixed`（默认）	✅ 移动	✅ 清空	❌ 不动	撤消 add + commit，保留本地修改重新提交
`--hard`	✅ 移动	✅ 清空	✅ 清空	彻底丢弃所有改动，回退到某个确定状态

关键理解：

--soft：只是「撤消 commit」，add 状态和文件内容都在
--mixed：撤消「commit + add」，文件修改保留但变为 unstaged
--hard：全部丢弃（⚠️ 谨慎使用）

2.2 基本用法

# --soft：只撤销 commit，保留暂存区（add 状态）
git reset --soft HEAD^         # 回退一个版本，重新 commit 即可

# --mixed（默认）：撤销 commit + add，保留本地修改
git reset HEAD^               # 等价于 git reset --mixed HEAD^
git reset origin/branchName   # 回退到远程分支最新版本，本地修改保留但需要重新 add + commit

# --hard：全部丢弃（不可逆）
git reset --hard HEAD         # 回到当前提交（啥也没干）
git reset --hard HEAD^        # 回到上一次提交
git reset --hard HEAD~100     # 回到前 100 个版本
git reset --hard commitId     # 回到指定 commit

2.3 reset 后如何找回？

git reset --hard 后 commit 不会立即消失，仍可通过 reflog 找回：

git reflog                    # 查看所有本地操作历史
git reset --hard <commitId>   # 恢复到被 reset 掉的版本

但注意：reflog 有过期时间（默认 90 天），且仅在本地有效，clone 到新机器就找不到了。

2.4 强制推送到远程

# reset 后远程分支指针落后于本地，需要强制推送
git push -f -u origin develop

# ✅ 推荐用 --force-with-lease（比 -f 更安全）
# 它会在推送前检查远程是否有新的提交，防止覆盖他人的代码
git push --force-with-lease origin develop

三、revert — 撤销提交（不改写历史）

3.1 基本原理

revert 不移动指针，而是创建一个新的提交，新提交的内容等于「目标提交的反向修改」。之前的提交历史全部保留，所以多人协作时其他人只需要 git pull 即可同步，不会有任何冲突风险。

      C1 --- C2 --- C3 --- C4（master）
                    ↑
              要撤销 C2
      ↓ revert C2 的效果
      C1 --- C2 --- C3 --- C4 --- R2（master）
                               ↑
                        新提交 R2 = -C2 的改动

3.2 基本用法

# 1. 找到要撤销的提交版本号
git log --oneline

# 2. 执行 revert（默认会弹出编辑器要求写 message，然后自动 commit）
git revert <commit-id>

# 3. 推送到远程
git push

3.3 不加 -n 的完整流程

git revert <commit-id>
# 弹出编辑器，输入 revert message（默认会自动生成）
# :wq 保存退出后自动产生一个新的 revert commit
git push

3.4 加 -n 的手动提交流程

git revert -n <commit-id>     # -n 表示只改文件不自动 commit
# 检查文件改动...
git commit -m "回退 xxx 提交"  # 手动提交
git push                      # 推送到远程

为什么用 -n？

如果想在 revert 的基础上再改点东西
如果 revert 产生了冲突，需要在解决冲突后再提交

3.5 ⚠️ revert 合并提交（重点）

这一步最容易踩坑。如果目标提交是合并提交（merge commit），直接 git revert 会报错，需要用 -m 指定主线：

# 查看合并提交的 parents
git log --merges --oneline

# 合并提交有两个 parent：
#   parent 1 = 合并时所在的分支（当前分支）
#   parent 2 = 被合并进来的分支
git revert -m 1 <merge-commit-id>
#   -m 1 → 保留当前分支的内容，撤消被合并分支的改动（常用）
#   -m 2 → 保留被合并分支的内容，撤消当前分支的改动

直观理解：

     feature
     /     \
---A-------M---C---D（main）

git revert -m 1 M → 保留 A→C→D 的演进，去掉 feature 分支的改动（就像 merge 没发生过）。
git revert -m 2 M → 保留 feature 分支的内容，去掉 main 分支 A→C→D 那一段的改动（极少用）。

四、场景决策速查

你的需求	推荐方案	原因
本地刚 commit 完，想改 message	`git reset --soft HEAD^`	最轻量，不留垃圾提交
本地 commit + add 了，想重新组织	`git reset --mixed HEAD^`	保留修改重新 add
本地改了测试代码不想提交了	`git reset --hard HEAD^`	清清爽爽不留痕
已推送远程，发现自己提交有 bug	`git revert <commit-id>` + `git push`	多人协作，不 rewrite 历史
已推送远程，想撤消一个合并	`git revert -m 1 <merge-commit-id>` + `git push`	-m 参数必须指定
误操作 reset --hard 想找回	`git reflog` → `git reset --hard <id>`	只要没 GC 就能救
想强制推送但怕覆盖别人代码	`git push --force-with-lease`	比 `-f` 多一重安全校验

五、最佳实践总结

未推送 → 用 reset（--soft / --mixed 优先）
已推送，共享分支 → 永远用 revert
已推送，私有分支 → 可以用 reset + force push，但推荐 --force-with-lease
revert 合并 → 必须带 -m 参数
心里没底 → 先 git stash 备份未提交的改动，再操作
养成习惯 → 大操作前记下当前 commitId：git rev-parse HEAD

Git 版本回退操作指南