git reset 移动当前分支的 HEAD 指针,并按指定模式决定要不要连带重置暂存区、工作区。它是「重做本地提交」的主力命令,也是最容易误删改动的命令。
本文列出 git reset 支持的全部模式与常用参数,用一张对照表讲清 --soft、--mixed、--hard 分别动了哪一层。
关于本系列
本文是《Git 使用教程》按命令拆分的第 13 / 28 篇,全部收录在 Git 栏目。参数表列的是日常高频项,并非穷举;想看某个命令的完整参数,用
git reset -h 看精简列表、git help reset 看完整手册。示例以 Git 2.56.0 为准。一、命令语法
先看语法骨架,再对照下一节的参数表。<占位> 表示必填值,实际输入时不要带尖括号;[...] 表示可选项,-- 用来分隔选项与路径。
bash语法
git reset [--soft | --mixed | --hard | --merge | --keep] [-q] [<commit>]
git reset [-q] [<tree-ish>] [--] <pathspec>...
二、参数逐项详解
下表按用途列出 git reset 的常用参数,每项都注明了「它到底改变了什么」。
| 参数 | 作用 |
|---|---|
--soft | 只移动 HEAD;索引与工作区原样保留,改动全部仍在暂存区 |
--mixed | 默认模式;移动 HEAD 并重置索引,工作区改动保留但变成未暂存 |
--hard | 移动 HEAD、重置索引、覆盖工作区,未提交的改动会丢失 |
--merge | 重置索引并更新差异文件,但保留本地未暂存改动;主要用于从失败的合并中脱身 |
--keep | 类似 --merge,若本地改动与目标冲突则直接中止,更安全 |
<commit> | 目标位置,默认 HEAD;常用 HEAD~1、origin/main、某个哈希 |
-p / --patch | 交互式按 hunk 把改动从索引撤出(git add -p 的逆操作) |
-N | 在 --mixed 下把被移除的路径标为 intent-to-add,便于重新拆分提交 |
-q / --quiet | 只报错误 |
-- <pathspec> | 带路径时只重置索引中的这些文件,不移动 HEAD |
三种主模式到底动了哪一层
| 模式 | HEAD 指针 | 暂存区 | 工作区 |
|---|---|---|---|
--soft | 移动 | 不变 | 不变 |
--mixed(默认) | 移动 | 重置为目标提交 | 不变 |
--hard | 移动 | 重置为目标提交 | 被覆盖 |
三、常用示例
重做最近一次提交
bash重做最近一次提交
git reset --soft HEAD~1 # 提交撤了,改动全在暂存区,改信息后重提
git reset HEAD~1 # 提交撤了,改动变成未暂存
git commit -m "fix: 补上单元测试"
把本地分支强行对齐远端
bash把本地分支强行对齐远端
git fetch --prune
git status -sb # 先看有没有未提交改动!
git reset --hard origin/main
只取消某个文件的暂存
bash只取消某个文件的暂存
git reset -- src/app.js # 等价于 git restore --staged src/app.js
git reset -p src/order.js
四、注意事项
--hard 之前必须先 stash
git reset --hard 会覆盖已跟踪文件的本地修改,且不会进回收站。执行前先 git status -sb,有改动就 git stash push -u。已经执行了也别慌:被撤掉的提交还能用 git reflog 找回,但从未暂存过的工作区改动找不回来。别对已公开的提交用 reset: 已经 push 的提交属于团队共享历史,
reset 之后再推会造成分叉。这种情况下应该用 git revert 生成一个反向提交。五、小结
一句话记住三个模式:--soft 只撤提交、--mixed 顺带撤暂存、--hard 连文件一起覆盖。判断标准永远是「我的改动还想不想留」,而不是「哪个命令看起来更彻底」。
本系列共 28 篇,一个命令一篇,完整目录见 Git 栏目。下一篇:git revert 命令参数详解。