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 命令参数详解。