版本控制与协作 / 系统课时
使用 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 处理。
- 验收条件:能比较日志结构与推送影响。
按自己的节奏,确认真正理解。