git restore 与 git reset 里选;已提交 → 看②
② 这个提交推送出去了吗?没推送 → git reset 改历史;推送过 → 只能用 git revert(它不改历史,只追加一个反向提交)。
「工作区 / 暂存区 / 历史」三列指这条命令会改变哪一份数据;写「不变」就是完全不动。 表中每行都在本卡第 2~7 段的实测里出现过。
| 场景 | 命令 | 工作区 | 暂存区 | 历史(提交) |
|---|---|---|---|---|
| 手滑改了文件,还没 add,想还原 | git restore a.txt |
还原成暂存区那版 | 不变 | 不变 |
| add 错了文件,想撤回暂存但保留改动 | git restore --staged a.txt |
不变 | 退回 HEAD 那版 | 不变 |
| 只想还原文件里某几块改动 | git restore -p a.txt |
逐块询问后还原 | 不变 | 不变 |
| 让工作区某文件回到历史某版 | git restore --source=HEAD~1 -- a.txt |
填入旧内容(并显示为已改动) | 不变 | 不变 |
| 提交早了:撤回提交,改动保持已暂存 | git reset --soft HEAD^ |
不变 | 不变 | 分支指针退一格 |
| 撤回提交,改动退回工作区(默认) | git reset HEAD^(= --mixed) |
受影响的文件变成已改动 | 退回 HEAD | 分支指针退一格 |
| 这次提交整个不要了,改动也扔 | git reset --hard HEAD^ |
被覆盖,未提交改动消失 | 退回 HEAD | 分支指针退一格 |
| 已推送的提交要撤销 | git revert <哈希> |
变更被反向应用 | 干净 | 原历史不动,追加一个反向提交 |
| 提交信息写错 / 漏加文件,还没推送 | git commit --amend |
不变 | 先 git add 补齐 | 该提交被替换(新哈希) |
| 合并/变基中途想退出 | git merge --abort |
回到操作前 | 回到操作前 | 不变 |
刚做完 reset 就后悔 |
git reset --hard ORIG_HEAD |
回到 reset 前 | 回到 reset 前 | 指针回到 reset 前 |
| 提交被 reset 掉,想找回来 | git reflog 查哈希 → git reset --hard <哈希> |
回到该提交 | 回到该提交 | 指针指过去 |
| 手头改动想先挪开一会儿 | git stash push -m "说明" |
改动被收走 | 收走 | 不变(存进 refs/stash) |
git restore:只管文件,永远不动历史restore 的来源树由 --source 指定:省略 = 暂存区;--staged 时省略 = HEAD。
# 场景:改了 a.txt,还没 add
git status --short
# M a.txt
git restore a.txt
git status --short
# (无输出 —— 三棵树又一致了)
# 场景:add 之后反悔,但改动要留着
printf 'line 1\nline 2 暂存了\n' > a.txt
git add a.txt
git status --short
# M a.txt
git restore --staged a.txt
git status --short
# M a.txt ← 暂存区退回 HEAD,工作区的内容没动
cat a.txt
# line 1
# line 2 暂存了
# 只撤其中一块(交互式,实测提示语)
printf 'line 1\nline 2 分两块改\n' > a.txt
printf 'y\n' | git restore -p a.txt
# (1/1) Discard this hunk from worktree [y,n,q,a,d,e,p,P,?]?
# ↑ y=丢掉这块 n=留 q=退出 a=全丢 d=全留 e=手工编辑 ?=帮助
git status --short
# (无输出)
# 用历史版本填回工作区(改回上一版内容,但仍显示为"已改动")
git restore --source=HEAD~1 -- a.txt
git status --short
# M a.txt
git reset:三个模式,差别只在「动几份数据」三种模式都做同一件事:把当前分支指针移到目标提交;区别在于顺带清不清暂存区和工作区。
| 模式 | 分支指针 | 暂存区 | 工作区 | 典型用途 |
|---|---|---|---|---|
--soft | 移动 | 不动 | 不动 | 把一次提交拆成两次、改提交信息 |
--mixed(默认) | 移动 | 清成目标提交的内容 | 不动 | 撤回提交,重新挑要提交的文件 |
--hard | 移动 | 清成目标提交的内容 | 覆盖 | 彻底扔掉这段工作 |
实测(同一个仓库、同一次提交,依次三种模式):
git log --oneline
# 9df5d5d 第三次提交:改 a.txt
# 5eb88a7 第二次提交:加入 c.txt
# 7d5520f 首次提交:加入 a.txt 与 b.txt
# ① --soft:输出为空,改动原封不动躺在暂存区
git reset --soft HEAD^
git status --short
# M a.txt
cat a.txt
# line 1
# line 2 第三次
# ② --mixed(默认,不写参数就是这个):改动掉回工作区
git reset HEAD^
# Unstaged changes after reset:
# M a.txt
git status --short
# M a.txt
# ③ --hard:输出明确告诉你落到了哪个提交
git reset --hard HEAD^
# HEAD is now at 5eb88a7 第二次提交:加入 c.txt
git status --short
# (无输出)
cat a.txt
# line 1
# line 2 ← 改动被彻底扔掉
--hard 不会删未跟踪文件,但会删掉「已 add、还没提交」的新文件:
git status --short 显示 A w.txt 时执行 git reset --hard HEAD,w.txt 从磁盘消失,
同时未跟踪的 ?? z.txt 还在。--hard 之后 .git/ORIG_HEAD 里存着reset 前的哈希(实测:文件内容就是
9df5d5d4daa436c4e3ed67a68bada5ac7f19fbc5),所以 git reset --hard ORIG_HEAD 可以立刻反悔,输出
HEAD is now at 9df5d5d 第三次提交:改 a.txt。reset 还是 revert:看有没有推送git reset | git revert | |
|---|---|---|
| 对历史做什么 | 移动分支指针,旧提交脱离分支(仍留在 reflog) | 不动旧提交,新增一个「反向应用」的提交 |
| 哈希会变吗 | 会:后续提交等于被换掉 | 不会:老提交原样保留 |
| 能对已推送的提交用吗 | 不能:别人手上的历史和你分叉,再推要强推 | 可以:这是共享分支的标准做法 |
| 典型场合 | 本机、只有自己、还没推 | 已经 push、别人可能已经拉过 |
动手之前,先看清「历史被改 / 分叉了」之后 push 的原话(实测,本地裸仓库当 origin,两边各多一个提交):
git push origin main
# To C:/Users/23652/AppData/Local/Temp/orig.git
# ! [rejected] main -> main (non-fast-forward)
# error: failed to push some refs to 'C:/Users/23652/AppData/Local/Temp/orig.git'
# hint: Updates were rejected because the tip of your current branch is behind
# hint: its remote counterpart. If you want to integrate the remote changes,
# hint: use 'git pull' before pushing again.
# hint: See the 'Note about fast-forwards' in 'git push --help' for details.
reset / --amend 之后 push 撞的就是同一堵墙:non-fast-forward。
新手对照表里写的「用 git pull」在这里不解决问题 —— 本地历史已经是另一条线,
pull 只会把两条线搅在一起(或再冲突一次)。要么改用 revert,要么在明确知道没人拉过时强推
(git push --force-with-lease,本卡不推荐默认使用)。
实测 git revert(撤销刚做的那个提交):
git revert --no-edit HEAD
# [main f51bda9] Revert "补上:把提交信息改对"
# Date: Fri Oct 16 22:22:03 2026 +0800
# 1 file changed, 1 insertion(+), 1 deletion(-)
git log --oneline
# f51bda9 Revert "补上:把提交信息改对" ← 新提交,历史往前长
# 27c0277 补上:把提交信息改对 ← 被撤销的那个还在
# 9df5d5d 第三次提交:改 a.txt
git log -1 --pretty="%h %s%n%b"
# f51bda9 Revert "补上:把提交信息改对"
# This reverts commit 27c0277ed82f0064580e8da5c29114e446111795.
# ↑ 提交信息由 Git 自动生成,正文里写明撤销的是哪一个哈希
边界(--no-edit 省掉编辑器,可改信息;撤销合并提交要 -m 1 指定保留哪一边的父提交):
本卡没实测合并提交的 revert,只按
git-revert 手册描述 —— git revert -m 1 <合并提交> 表示「以第 1 个父提交为基线反向应用」。
git commit --amend:改写最近一次提交git log --oneline
# 9b582c7 手滑:提交信息写错了
# 9df5d5d 第三次提交:改 a.txt
git commit --amend -m "补上:把提交信息改对"
# [main 27c0277] 补上:把提交信息改对
# Date: Fri Oct 16 12:00:00 2026 +0800
# 1 file changed, 1 insertion(+), 1 deletion(-)
git log --oneline
# 27c0277 补上:把提交信息改对
# 9df5d5d 第三次提交:改 a.txt
# ↑ 9b582c7 那个哈希已经不在分支上:amend 是"造个新的替掉旧的"
git add 漏掉的文件,再 git commit --amend --no-edit(--no-edit = 提交信息不改)。-m / --no-edit 会打开编辑器改信息;在编辑器里保存空信息即放弃这次 amend。git reflog:最后的找回手段HEAD 每移动一次(提交、reset、amend、revert、切换分支)都会留一条记录,只在本机、默认保留 90 天。
git reflog
# f51bda9 HEAD@{0}: revert: Revert "补上:把提交信息改对"
# 27c0277 HEAD@{1}: commit (amend): 补上:把提交信息改对
# 9b582c7 HEAD@{2}: commit: 手滑:提交信息写错了
# 9df5d5d HEAD@{3}: reset: moving to ORIG_HEAD
# 5eb88a7 HEAD@{4}: reset: moving to HEAD^
# 9df5d5d HEAD@{5}: commit: 第三次提交:改 a.txt
# 7d5520f HEAD@{13}: commit (initial): 首次提交:加入 a.txt 与 b.txt
# ↑ 左列哈希 + HEAD@{n}(n 是"往回数第几次") + 动作 + 说明
# 想要真实时间而不是 @{0} 编号:
git reflog --date=iso
# f51bda9 HEAD@{2026-10-16 12:10:00 +0800}: revert: Revert "补上:把提交信息改对"
# 找回流程(实测:先故意退两格,再捞回来)
git reset --hard HEAD~2
# HEAD is now at 9df5d5d 第三次提交:改 a.txt
git reflog | head -3
# 9df5d5d HEAD@{0}: reset: moving to HEAD~2
# f51bda9 HEAD@{1}: revert: Revert "补上:把提交信息改对" ← 丢掉的那个就在这儿
git reset --hard f51bda9
# HEAD is now at f51bda9 Revert "补上:把提交信息改对"
# ↑ 或者更稳:git branch 救回 f51bda9 (留个分支,再慢慢看)
| 问题 | 答案 |
|---|---|
| reflog 保留多久 | 默认 90 天(gc.reflogExpire);其中「已不可达」的记录默认 30 天(gc.reflogExpireUnreachable) |
| 换台机器还能查吗 | 不能。reflog 是本机日志,刚从远端克隆下来的仓库里只有本地操作产生的那几条 |
| 记录被 gc 清了怎么办 | 用 git fsck --lost-found 找悬空对象,能捞回的对象写在 .git/lost-found/ 下;成功率低于 reflog |
| 对象还在但记录没了 | 只要哈希还记得(比如贴过日志),git cat-file -p <哈希> 就能确认它还在 |
| 旧写法 | 等价的新写法 | 实测 |
|---|---|---|
git checkout -- a.txt | git restore a.txt | 两者跑完 git status --short 都由 M a.txt 变成无输出 |
git reset HEAD -- a.txt | git restore --staged a.txt | 由 M a.txt 变成 M a.txt,内容不变 |
git checkout <哈希>(进分离头指针) | git switch --detach <哈希> | 语义相同;新命令把「切分支」和「切提交」分开表述 |
git reset --hard 清一批工作区改动 | 逐个 git restore <路径> | 后者只动指定路径,不会误伤同目录其它文件 |
git stash:改动先挪开(实测行为)git status --short
# M a.txt
# ?? tmp.txt
git stash push -m "临时收起来"
# Saved working directory and index state On main: 临时收起来
git status --short
# ?? tmp.txt ← 默认不碰未跟踪文件,tmp.txt 还在原地
git stash list
# stash@{0}: On main: 临时收起来
git stash pop
# On branch main
# Changes not staged for commit:
# modified: a.txt
# Untracked files:
# tmp.txt
# Dropped refs/stash@{0} (25ca6ca0a1f3dc04f89a7ca4fdf24890d521cb61)
# 要连未跟踪一起收:git stash push -u -m "连未跟踪一起收"
# 实测:执行后 tmp.txt 从磁盘消失("No such file or directory"),pop 后回来
stash 不改历史,存的是 refs/stash 这个引用下的提交对象;误删可用 git fsck 找,
或看 git-stash 手册的 list / apply / drop。
| 命令 | 会丢什么 | 防呆做法 |
|---|---|---|
git reset --hard | 未提交的工作区改动;已 add 未提交的新文件 | 先 git stash push -u,或先 git status --short 确认没有 A/M 行 |
git clean -fd | 未跟踪文件与目录(实打实删磁盘) | 先 git clean -nd 干跑看要删什么 |
git reset / --amend(已推送) | 别人的历史与你的分叉 | 已推送就改用 git revert |
git checkout <文件>(在分离头指针里) | 看着像回退,其实不是;容易误判当前在哪 | 用 git switch / git restore 明确区分 |
git stash pop 之后又 stash drop | stash 里那份改动 | 先 pop 确认无误再 drop;reflog 里通常还找得到 |
实测「先干跑」这一步长什么样(未跟踪文件未提交时):
git clean -nd
# Would remove junk.txt
# Would remove junkdir/
# ↑ -n 只列不删;-nd 会带目录;确认无误再换成 -qfd 真删
1. 已经 git push 的提交里有段代码要撤掉,用哪条?
对。前三个都会重写哈希:别人已经拉过的历史一改就分叉,再推得强推。revert 只追加新提交,是共享分支上唯一安全的撤法。
2. git reset --soft HEAD^ 之后,刚才那次提交的改动在哪?
对。--soft 只把分支指针往回挪,index 与工作区都不动,所以那次提交的内容仍是"已暂存"状态 —— 直接 git commit 就能换个信息重提。
3. 误跑了 git reset --hard HEAD~3,三个提交从分支上消失。首选怎么救?
对。reset 只移动指针,旧提交还在 .git/objects 里,reflog 记着移动前的哈希(或直接 git reset --hard ORIG_HEAD)。这也是为什么「丢了东西先别乱敲,先看 reflog」。