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

使用 reset 移动提交位置

使用 reset 移动提交位置

学习目标

完成本课后,你将能够:

  • 解释 reset 对分支指针的作用
  • 比较 soft、mixed 与 hard 三种模式
  • 根据保留范围选择安全模式

问题背景或应用场景

提交后发现需要重新组织历史时,可以移动当前分支指针。reset 是强大但容易误用的命令,因为不同模式决定提交、暂存区和工作区分别保留到什么程度。尤其 --hard 会覆盖未提交内容,必须明确边界。

核心原理

git reset <目标> 首先把当前分支移动到目标提交,然后根据模式处理暂存区和工作区。--soft 只移动分支,原提交内容保持已暂存;默认的 --mixed 还会把暂存区恢复到目标提交,但工作区保留;--hard 同时把工作区恢复到目标提交。

模式 分支指针 暂存区 工作区
--soft 移动 保留 保留
--mixed 移动 重置 保留
--hard 移动 重置 重置

对已经推送的共享提交,通常不应使用 reset 改写历史,而应使用 revert 创建反向提交。

Git reset 三种模式对照图

基础用法

需要重做最近提交且保留暂存内容时使用 --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=1

Tips

  • 执行 reset 前创建临时分支是低成本保险。
  • 在共享分支上优先选择 revert。
  • 误 reset 后尽快查看 reflog,避免引用日志过期。

常见错误

1. 把 mixed 当作丢弃修改

  • 错误表现:重置后文件仍是新内容。
  • 产生原因:默认 mixed 只重置暂存区,不覆盖工作区。
  • 正确处理:需要保留修改就重新暂存;确需丢弃时先确认再使用 hard。
  • 修复结果:操作结果符合预期保留范围。

2. 对已推送历史 hard reset

  • 错误表现:本地与远程分支分叉,推送被拒绝。
  • 产生原因:改写了其他人可能已基于其开发的历史。
  • 正确处理:恢复原引用或与团队确认,优先使用 revert。
  • 修复结果:共享历史保持可追踪。

本课练习

1. 重做提交说明

  • 任务目标:使用 soft reset。
  • 输入或初始条件:最近提交内容正确但说明错误。
  • 实现要求:软重置后重新提交。
  • 验收条件:文件内容不变,提交说明更新。

2. 重新拆分提交

  • 任务目标:使用 mixed reset。
  • 输入或初始条件:最近提交包含两个无关文件。
  • 实现要求:混合重置后分两次暂存提交。
  • 验收条件:历史出现两个逻辑清晰的提交。

3. 验证 hard 风险

  • 任务目标:在安全实验仓库观察覆盖。
  • 输入或初始条件:工作区有未提交修改。
  • 实现要求:记录内容后执行 hard reset。
  • 验收条件:能够说明哪些内容被永久覆盖。
按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

使用 reset 移动提交位置

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

登录哪都通