版本控制与协作 / 系统课时

使用 revert 安全撤销提交

使用 revert 安全撤销提交

学习目标

完成本课后,你将能够:

  • 通过新提交撤销历史变更
  • 区分 revert 与 reset 的历史影响
  • 在共享分支中安全回退问题提交

问题背景或应用场景

生产分支上的错误提交已经推送后,直接移动分支会破坏共享历史。git revert 不删除原提交,而是计算其反向变化并创建新提交,因此团队成员可以正常获取,审计链也保持完整。

核心原理

revert 的目标是“撤销某次提交带来的变化”,不是“回到某个时间点”。它读取目标提交与其父提交的差异,生成相反补丁并提交。原错误提交仍然可见,后续可以理解何时引入、何时撤销。

撤销普通提交通常直接使用 git revert <提交>。撤销合并提交需要指定主线父提交,语义更复杂,应先在测试分支验证。若后续再次引入原功能,还要考虑“撤销的撤销”或新的实现提交。

基础用法

先用 git show <提交> 确认目标,再执行 git revert <提交>。自动生成的提交说明应保留关键上下文。发生冲突时解决后执行 git revert --continue,放弃则使用 git revert --abort。

完整可运行示例

以下命令使用 Bash 语法,并在独立测试目录中执行。示例只使用本地仓库或本地裸仓库模拟远程服务,不依赖互联网;提交哈希、绝对路径等动态值不作为固定输出。

bash
rm -rf git-revert-demo
mkdir git-revert-demo
cd git-revert-demo
git init -q -b main
git config user.name "Anystack Student"
git config user.email "student@example.com"
printf "version=1
" > app.txt
git add app.txt
git commit -q -m "feat: version 1"
printf "version=2
" > app.txt
git add app.txt
git commit -q -m "feat: version 2"
git revert --no-edit HEAD >/dev/null 2>&1
printf "file: "
cat app.txt
printf "history:
"
git log --format=%s --reverse

预期输出

text
file: version=1
history:
feat: version 1
feat: version 2
Revert "feat: version 2"

Tips

  • revert 前确认目标提交是否还包含其他必要修改。
  • 对连续提交可逐个撤销,顺序通常从新到旧更容易。
  • 撤销合并提交前先理解 -m 主线参数。

常见错误

1. 误以为原提交会消失

  • 错误表现:日志中仍能看到错误提交。
  • 产生原因:revert 设计目标就是保留历史并添加反向提交。
  • 正确处理:检查最新提交和最终文件状态,而不是只看原提交是否存在。
  • 修复结果:历史完整且效果已撤销。

2. 撤销了包含多类改动的提交

  • 错误表现:必要功能也被同时移除。
  • 产生原因:原提交粒度过大。
  • 正确处理:评估是否应手动恢复部分内容,今后保持原子提交。
  • 修复结果:最终状态只撤销目标变化。

本课练习

1. 撤销指定旧提交

  • 任务目标:练习非 HEAD 目标。
  • 输入或初始条件:历史中间有一个独立文档提交。
  • 实现要求:撤销该提交。
  • 验收条件:后续提交保留,文档变化被反向处理。

2. 处理 revert 冲突

  • 任务目标:观察反向补丁冲突。
  • 输入或初始条件:目标文件在错误提交后又被修改。
  • 实现要求:执行撤销并手动解决冲突。
  • 验收条件:最终状态符合业务意图且存在撤销提交。

3. 比较 reset 与 revert

  • 任务目标:理解共享历史选择。
  • 输入或初始条件:复制同一实验仓库两份。
  • 实现要求:分别用 reset 和 revert 处理。
  • 验收条件:能比较日志结构与推送影响。
按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

使用 revert 安全撤销提交

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通