AIGC标识 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 再按。


本文由实际踩坑整理,欢迎评论区补充。

posted on 2026-11-06 17:07  小沙盒工作室  阅读(11)  评论(0)    收藏  举报