Git 回退实战笔记:丢弃未 add 的改动 & 回到历史 commit(含老版本 git 兼容)
Git 回退实战笔记:丢弃未 add 的改动 & 回到历史 commit(含老版本 git 兼容)
背景
日常开发里经常出现这种情况:
手写了一堆代码,
git add都还没执行,结果发现思路错了,想整段丢掉,把文件恢复成某个 commit 的样子。
听起来简单,但真动手时会踩几个坑:
git restore在老版本 git 上根本不存在(restore是 git 2.23,2019 年才引入的);git checkout -- .里的--不能省;- 未跟踪的新文件(Untracked)
restore/checkout都删不掉; reset --hard用力过猛会把 commit 也一起抹掉。
这篇笔记把「丢弃未 add 改动 + 回到指定 commit」的完整命令整理一遍,并附上新老 git 的命令对照表。
一、先看清楚现状:git status
动手之前先跑一次:
git status
输出分三块,对应三种不同处理方式:
| 区域 | 含义 | 回退命令 |
|---|---|---|
| Changes to be committed | 已 add,在暂存区 |
git reset HEAD .(新版 git restore --staged .) |
| Changes not staged for commit | 改了但没 add |
git checkout -- . |
| Untracked files | 新文件,git 没管过 | git clean -fd |
要看具体改了啥:
git diff --cached # 已 add 的改动
git diff # 没 add 的改动
二、核心需求:丢弃「没 add」的改动
情况 1:回到当前最新 commit(HEAD)
新版 git(2.23+):
git restore .
老版 git(2.23 之前):
git checkout -- .
作用一样:把所有未暂存的改动还原成 HEAD(最近一次 commit)的样子。
⚠️ 注意
--不能省。它的作用是告诉 git「后面跟的是路径,不是分支名」,防止歧义。
只还原某个文件:
git checkout -- path/to/file
情况 2:回到「更早的某个 commit」的内容
先查历史:
git log --oneline
假设要回到 abc1234:
新版:
git restore --source=abc1234 .
老版:
git checkout abc1234 -- .
效果:当前工作区所有文件变成 abc1234 那个 commit 的内容,但 HEAD 和历史都不动,之后可以在这基础上重新改、重新提交。
三、新版 vs 老版 git 命令对照表
| 目的 | 新版(≥2.23) | 老版(<2.23) |
|---|---|---|
| 丢弃未暂存改动 | git restore . |
git checkout -- . |
| 只丢某个文件 | git restore <file> |
git checkout -- <file> |
| 恢复到指定 commit 内容 | git restore --source=<hash> . |
git checkout <hash> -- . |
| 取消 add(保留改动) | git restore --staged . |
git reset HEAD . |
| 撤销最近一次 commit(保留改动) | git reset --soft HEAD~1 |
同左 |
先确认自己的版本:
git --version
四、顺手清掉未跟踪的新文件
restore / checkout 都删不掉 Untracked 文件,因为它们根本不在 git 管理里。要用 clean:
git clean -nd # dry-run,先看会删什么,强烈建议先跑这个
git clean -fd # 确认无误后再真删(不可逆!)
参数说明:
-n/--dry-run:只打印,不真删-f:强制,因为clean.requireForce默认开启-d:同时删未跟踪的目录
五、更狠的回退:git reset --hard
如果你确定「之后的 commit 也不要了」,可以直接把分支退到某个 commit:
git reset --hard abc1234
| 命令 | 影响范围 |
|---|---|
git reset --hard HEAD |
只丢未提交改动(已 add + 未 add 都丢) |
git reset --hard abc1234 |
丢掉 abc1234 之后的所有 commit 和未提交改动 |
⚠️ reset --hard 会同时清空暂存区和工作区,且不可逆。用之前一定先备份(见下一节)。
六、安全网:备份再动手
凡是 --hard、clean -fd 这类不可逆操作,先保一手:
方式一:stash 备份
git stash push -u -m "backup before reset"
-u 连未跟踪文件一起存。之后想找回:
git stash list
git stash pop
方式二:开备份分支
git branch backup-$(date +%s)
误操作后怎么救:
git reflog # 找到被 reset 掉的 commit 哈希
git reset --hard <hash> # 救回来
七、小结
| 需求 | 命令 |
|---|---|
| 只看状态 | git status |
| 丢弃没 add 的改动(回到 HEAD) | git checkout -- . / git restore . |
| 丢弃没 add 的改动(回到旧 commit) | git checkout <hash> -- . / git restore --source=<hash> . |
| 取消 add,保留改动 | git reset HEAD . / git restore --staged . |
| 删除未跟踪文件 | git clean -nd → git clean -fd |
| 分支回退到某 commit | git reset --hard <hash>(谨慎) |
| 备份再动手 | git stash push -u -m "backup" |
一句话记忆:
没 add 的改动用
checkout --(或restore)丢;未跟踪文件用clean删;reset --hard是核弹,先 stash 再按。
本文由实际踩坑整理,欢迎评论区补充。
浙公网安备 33010602011771号