git-revert 安全撤销提交

1. revert 概述#

1.1 什么是 revert#

git revert 创建一个新的反向提交来撤销指定提交的变更，不修改历史。

原始: A---B---C---D (HEAD)
revert D: A---B---C---D---D' (HEAD)
                         ↑ D' 是 D 的反向操作

1.2 revert vs reset#

2. 基本用法#

2.1 撤销单个提交#

git revert abc1234
# 打开编辑器编辑 revert 消息

2.2 不自动提交#

git revert -n abc1234
# 变更放入暂存区与工作区，不自动提交
# 可以拆分调整后再统一提交

2.3 撤销多个提交#

# 撤销连续区间（左开右闭：不含 abc1234 本身）
git revert abc1234..def5678
# 要包含起点则写 abc1234^..def5678

# 撤销多个不连续的提交（按给定顺序逐个反向）
git revert abc1234 def5678 8c9d0e1

2.4 修改 revert 消息#

revert 默认生成 Revert "<原提交标题>" 格式的消息。想自定义：

git revert -e abc1234              # 提交前打开编辑器修改消息
# 或不自动提交，手工整理后提交：
git revert -n abc1234
git commit -m "revert: 回退认证功能（原因：...）"

3. 合并提交的 revert#

3.1 指定父提交#

合并提交有多个父提交，revert 时需要指定保留哪个：

# 查看合并提交的父提交
git cat-file -p abc1234
# parent def5678  ← 第一个父提交（主分支）
# parent ghi9012  ← 第二个父提交（合并分支）

# revert 保留第一个父提交（撤销合并分支的变更）
git revert -m 1 abc1234

# revert 保留第二个父提交（撤销主分支的变更）
git revert -m 2 abc1234

3.2 重新合并#

revert 合并提交后，如果需要重新合并，需要先 revert 那个 revert 提交：

# 1. revert 合并提交
git revert -m 1 merge-commit

# 2. 后续需要重新合并
git revert revert-commit    # revert 那个 revert
git merge feature           # 重新合并

4. 冲突处理#

4.1 revert 冲突#

如果 revert 的提交之后有相关修改，可能产生冲突：

git revert abc1234
# CONFLICT: ...

# 解决冲突
vim conflicted-file.js
git add .
git revert --continue

# 或放弃
git revert --abort

5. 实际场景#

5.1 回退已推送的功能#

# 发现功能有严重 Bug，需要回退
git revert abc1234
git push origin main

5.2 回退发布#

# 回退整个发布
git revert v1.0.0..v1.1.0
git push origin main

5.3 撤销时写清原因#

# 错误提交已推送：revert 消息默认引用原提交，补充说明用 -e 编辑
git revert -e wrong-commit
# 消息模板：
#   Revert "feat: wrong feature"
#   This reverts commit abc1234...
#   （在此补充回退原因、影响面与后续计划）

revert 基本用法#

基本写法：撤销单个提交 git revert <提交哈希>

# 撤销 abc1234 提交
git revert abc1234;

基本写法：不自动提交 git revert -n <提交哈希>

# 撤销 abc1234 但不自动提交
git revert -n abc1234;

基本写法：撤销连续多个提交 git revert <起始哈希>..<结束哈希>

# 撤销 abc1234（不含）之后到 def5678（含）的提交
git revert abc1234..def5678;

基本写法：撤销多个不连续提交 git revert <哈希1> <哈希2> <哈希3>

# 按给定顺序逐个反向
git revert abc1234 def5678 8c9d0e1;

基本写法：编辑 revert 消息 git revert -e <提交哈希>

# 提交前打开编辑器补充回退原因
git revert -e abc1234;

基本写法：不自动提交后手工整理 git revert -n <提交哈希>

git revert -n abc1234;
git commit -m "revert: 回退认证功能（原因：...）";

合并提交的 revert#

基本写法：查看合并提交的父提交 git cat-file -p <合并提交哈希>

# 查看 abc1234 合并提交的父提交
git cat-file -p abc1234;

基本写法：revert 保留第一个父提交 git revert -m 1 <合并提交哈希>

# 撤销合并提交，保留主分支的变更
git revert -m 1 abc1234;

基本写法：revert 保留第二个父提交 git revert -m 2 <合并提交哈希>

# 撤销合并提交，保留合并分支的变更
git revert -m 2 abc1234;

重新合并已撤销的分支#

基本写法：revert 之前的 revert git revert <revert提交哈希>

# 恢复被撤销的合并
git revert revert-commit;

基本写法：重新合并分支 git merge <分支名>

# revert revert 后重新合并 feature 分支
git merge feature;

revert 冲突处理#

基本写法：触发 revert 冲突 git revert <提交哈希>

# 触发 revert 冲突
git revert abc1234;

基本写法：添加解决后的文件 git add .

# 添加解决冲突后的文件
git add .;

基本写法：继续 revert 流程 git revert --continue

# 继续 revert 流程
git revert --continue;

基本写法：放弃 revert git revert --abort

# 放弃当前 revert 操作
git revert --abort;

reset 撤销提交#

基本写法：软回退 git reset --soft HEAD~<n>

# 撤销最近一次提交，修改保留在暂存区
git reset --soft HEAD~1;

基本写法：混合回退 git reset --mixed HEAD~<n>

# 撤销最近一次提交，修改保留在工作区
git reset --mixed HEAD~1;

基本写法：硬回退 git reset --hard HEAD~<n>

# 撤销最近一次提交并丢弃修改
git reset --hard HEAD~1;

撤销工作区修改#

基本写法：撤销单个文件修改 git checkout -- <file>

# 撤销 src/index.js 的工作区修改
git checkout -- src/index.js;

基本写法：使用 restore 撤销 git restore <file>

# 撤销指定文件修改（Git 2.23+）
git restore src/index.js;

撤销暂存#

基本写法：取消暂存（保留修改） git reset HEAD <file>

# 将 src/index.js 移出暂存区
git reset HEAD src/index.js;

基本写法：使用 restore 撤销暂存 git restore --staged <file>

# 取消暂存但保留工作区修改（Git 2.23+）
git restore --staged src/index.js;

实际场景#

基本写法：回退已推送的功能 git revert <提交哈希>

# 撤销已推送的 abc1234 提交
git revert abc1234;

基本写法：推送撤销结果 git push <远程仓库名> <分支名>

# 推送撤销结果到远程
git push origin main;

基本写法：回退整个发布 git revert <起始标签>..<结束标签>

# 回退 v1.0.0 到 v1.1.0 之间的所有提交
git revert v1.0.0..v1.1.0;

基本写法：安全撤销错误提交 git revert <错误提交哈希>

# 撤销错误提交
git revert wrong-commit;

基本写法：补充撤销原因说明 git commit -m "<消息>"

# 提交撤销原因说明
git commit -m "revert: 回退错误提交，原因：...";