版本控制与协作 / 系统课时
使用 reset 移动提交位置
使用 reset 移动提交位置
学习目标
完成本课后,你将能够:
- 解释 reset 对分支指针的作用
- 比较 soft、mixed 与 hard 三种模式
- 根据保留范围选择安全模式
问题背景或应用场景
提交后发现需要重新组织历史时,可以移动当前分支指针。reset 是强大但容易误用的命令,因为不同模式决定提交、暂存区和工作区分别保留到什么程度。尤其 --hard 会覆盖未提交内容,必须明确边界。
核心原理
git reset <目标> 首先把当前分支移动到目标提交,然后根据模式处理暂存区和工作区。--soft 只移动分支,原提交内容保持已暂存;默认的 --mixed 还会把暂存区恢复到目标提交,但工作区保留;--hard 同时把工作区恢复到目标提交。
| 模式 | 分支指针 | 暂存区 | 工作区 |
|---|---|---|---|
--soft |
移动 | 保留 | 保留 |
--mixed |
移动 | 重置 | 保留 |
--hard |
移动 | 重置 | 重置 |
对已经推送的共享提交,通常不应使用 reset 改写历史,而应使用 revert 创建反向提交。

基础用法
需要重做最近提交且保留暂存内容时使用 --soft;希望重新选择暂存文件时使用 --mixed;只有确认工作区内容全部可丢弃时才使用 --hard。执行前记录 git status 和当前提交,必要时创建备份分支。
完整可运行示例
以下命令使用 Bash 语法,并在独立测试目录中执行。示例只使用本地仓库或本地裸仓库模拟远程服务,不依赖互联网;提交哈希、绝对路径等动态值不作为固定输出。
bash
rm -rf git-reset-modes-demo
mkdir git-reset-modes-demo
cd git-reset-modes-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 reset -q --soft HEAD~1
printf "soft-head: "
git log -1 --format=%s
printf "soft-status: "
git status --short
git commit -q -m "feat: version 2"
git reset -q --mixed HEAD~1
printf "mixed-status: "
git status --short
git add app.txt
git commit -q -m "feat: version 2"
git reset -q --hard HEAD~1
printf "hard-file: "
cat app.txt预期输出
text
soft-head: feat: version 1
soft-status: M app.txt
mixed-status: M app.txt
hard-file: version=1Tips
- 执行 reset 前创建临时分支是低成本保险。
- 在共享分支上优先选择 revert。
- 误 reset 后尽快查看 reflog,避免引用日志过期。
常见错误
1. 把 mixed 当作丢弃修改
- 错误表现:重置后文件仍是新内容。
- 产生原因:默认 mixed 只重置暂存区,不覆盖工作区。
- 正确处理:需要保留修改就重新暂存;确需丢弃时先确认再使用 hard。
- 修复结果:操作结果符合预期保留范围。
2. 对已推送历史 hard reset
- 错误表现:本地与远程分支分叉,推送被拒绝。
- 产生原因:改写了其他人可能已基于其开发的历史。
- 正确处理:恢复原引用或与团队确认,优先使用 revert。
- 修复结果:共享历史保持可追踪。
本课练习
1. 重做提交说明
- 任务目标:使用 soft reset。
- 输入或初始条件:最近提交内容正确但说明错误。
- 实现要求:软重置后重新提交。
- 验收条件:文件内容不变,提交说明更新。
2. 重新拆分提交
- 任务目标:使用 mixed reset。
- 输入或初始条件:最近提交包含两个无关文件。
- 实现要求:混合重置后分两次暂存提交。
- 验收条件:历史出现两个逻辑清晰的提交。
3. 验证 hard 风险
- 任务目标:在安全实验仓库观察覆盖。
- 输入或初始条件:工作区有未提交修改。
- 实现要求:记录内容后执行 hard reset。
- 验收条件:能够说明哪些内容被永久覆盖。
按自己的节奏,确认真正理解。