NOTES · 学习笔记

Git 后悔药指南:从 restore 到 reflog

Git约 10 分钟

开始前:先搞懂三层存档模型

git 给代码记了三个存档层:工作区(你正在改的文件)→ 暂存区(git add 过、准备提交的)→ commit(正式存档)。

五关的药为什么不同,全看搞砸的东西存档到哪一层:没 add → restore;刚 commit 且没 push → amend/reset;已 push → revert;连 commit 都被 reset 掉了 → reflog。

核心原则:只要 commit 过,基本都能救回来;真正危险的是没 commit 的改动。

Level1:修改还在工作区,还没有commit

场景:

今天我们写了10-12行的代码,不过写完发现自己逻辑和思绪全部错乱,我们想删掉今天写的内容,回溯到上一个版本,因为没有commit,所以并不困难。

首先,我们先看状态:

我们看当前status

modified: app.py: app.py 被改了,改动只存在于工作区,还没存档(没 commit)

debug_notes.txt:新文件,git 完全不认识它

最下面那行 no changes added to commit: git add 都还没做

这种情况是最轻的,我们接下来回溯

先看diff,看看我们实际改了什么

绿色内容就是我们新的改动。我们现在回溯

使用git restore app.py 指令

代码回到上一个commit版本。Level1完成

Level2:修正commit

想象你昨天在赶一个功能:给程序加一个“告别函数”(farewell),写完顺手 commit 了。当时你很困,犯了两个错:

commit message 打错了字:写成“添加告别 gunciton",function 拼成了 gunciton。commit message 相当于存档备注,以后翻历史全靠它,错字会让别人看不懂。

漏了一个文件:程序还依赖一个 config.yaml(配置文件),你写完它却忘了 git add,所以这次 commit 里没有它。要是照这个版本把代码发给别人,程序跑都跑不起来。

我们先看状态和日志

当前status是这个yaml文件还没有提交上去

当前log写的是git log --oneline:两条 commit,每行开头是 commit-id(这个仓库里的“存档编号”)。5580a5c 就是那条错字提交,(HEAD -> main) 标在它身上,这串标记的意思是:HEAD(你现在所处的位置)指向 main 分支,main 分支指向这条 commit。

我们的目标是将 commit 那条的 gunciton 改为正确名字,并且把还没提交的 yaml 文件加进去。

我们只需要git add +文件名 就将当前文件添加进入暂存区

我们再来处理名字

git commit —— 提交/存档,把你暂存区里的内容正式打包

--amend —— 修正模式:不是新建一条提交,而是重打最近一次存档——新提交会替换掉刚才那个 5580a5c

-m "feat: 添加告别函数" —— -m = message,直接在命令里写提交备注

红线:amend 会改写历史(commit-id 会变),只对没 push 过的提交安全。已 push 的提交用 amend,就要强推远程,坑全组。

最后我们来看看当前日志

Level3:代码已经push上去了,现在想修改bug

比如你在项目里加了个“除法功能”(divide 函数),git commit 然后 git push 推送到了远程仓库——就像平时发版一样,发完你才发现:这个函数有 bug,除数为 0 时程序会直接崩。

这次不能用 amend/reset 这类改写历史的办法,因为远程历史里已经有了这条 bug 提交,origin/main 指着它。同事可能已经基于它拉取、开发,他们的电脑里也有这条提交

如果你现在改写历史再强行推上去,同事那边的本地历史就和远程对不上号了,他们一推送就是冲突和混乱。

补救步骤:

确认 bug 提交确实已在远程:git log --oneline origin/main

找到 bug 提交的编号:git log --oneline

git revert <编号> —— git 会自动生成反向提交,并弹出 vim 编辑器让你确认 message:先切英文输入法(中文全角冒号 vim 不认),按 Esc,输入 :wq 回车保存退出

git push 把冲销提交推上去

编号确认:0453777 就是当前有 bug 的那条提交

我们引入一个revert

git revert 编号= "git 帮你生成一条新提交,内容正好把那条提交做的改动全部撤销。”

分三步理解:

1. 它不改过去,只加新页

历史像一本只许往后写、不许涂改的账本。revert 不翻旧账、不撕页,它只在最新处添一页。

2. 新页的内容 = 旧提交的“镜像反做”

bug 提交往代码里加了 divide 函数 3 行 → revert 自动生成的新提交就是删掉这 3 行。一加一删,抵消,代码回到 bug 出现之前。

你不用自己写一行反向代码,git 全部自动算好——你只需要告诉它撤销哪条(编号)。

3. 所以历史变长了,而不是变短了

输入 git revert 0453777

第一行 Revert "feat: 新增除法运算(有bug)" —— 已经帮你写好的提交信息,不用改

第二行说明这条提交会撤销哪个 commit(完整编号)

# 开头的行全是注释说明,不会进提交信息(# On branch main、modified: app.py——顺带确认了它真的要提交一个 app.py 的反向修改)

当前状态

我们重新push上去

完成level3

Level4:时光机

场景:你在一个新分支上开发,经过几天尝试,你做了好几次错误提交,分支逻辑已经混乱不堪。你只想彻底放弃这几天所有改动,让分支回到某一天某个清晰,正确的commit状态

当前日志状态。

我们要回到8a0dd85 feat: 添加告别函数。

git reset --hard 8a0dd85

git reset —— 重置:把“分支指针”搬家。main 这个书签不再夹在“实验B”那页,改夹到你指定的页

--hard —— 力度档位,决定 reset 改多少东西。reset 有三档力度:

--soft:只挪书签(历史变了),你的文件原封不动——适合“想重新组织一下提交”

--mixed(默认):挪书签 + 清打包台(暂存区),文件还是不动

--hard:挪书签 + 清暂存区 + 连硬盘上的文件一起覆盖成过去的样子,三层全部回滚

8a0dd85 —— 目的地编号:时光机的坐标,你去哪个时刻全由它决定

合起来:“把 main 分支搬回 8a0dd85 那一刻,并且让暂存区和硬盘文件也变成那一刻的样子。”

--hard 为什么要三思:它是三条命令里唯一会销毁工作区文件内容的。没 commit 的改动、实验A/B 的代码,一刀全没。所以:

动手前必须确认:要丢弃的东西真的不要了

只能用在没 push 的本地历史上

真开过头了还有 reflog 兜底

Level5:终极后悔药

情景:你加了告别函数,又提交了一条“加了一堆实验函数”。然后你想把实验函数抹掉,于是敲了 git reset --hard <编号>——结果编号指错了:回到了告别函数,把“加了一堆实验函数”这条提交甩掉了。

现在你的处境:

app.py 被覆盖成最原始的版本——告别函数、实验函数,全没了

git log 里只剩两条,被甩掉的那条提交完全看不到了

被甩掉的那条提交编号,log 里查不到(之前见过,但记不住 7 位乱码)

reflog(Reference Log,指针流水账)——git 偷偷记的另一本账:

git log 记录的是“历史链条长什么样”;git reflog 记录的是"HEAD 这个你本人,每一步都站过哪"——每次 commit、每次 reset、每次 amend 之前你在哪个 commit、之后到了哪个,一笔不落。reset 甩掉的提交,在流水账里编号清清楚楚。

所以这关的解法套路:git reflog 查到“出事之前”那条记录的编号 → 拿着编号再 reset 一次 → 起死回生。

我们现在的位置在添加告别函数这里。

40046d1 HEAD@{0}: reset: moving to 40046d1...     ← 最新动作:reset!事故就发生在这
6bd51bb HEAD@{1}: commit: feat: 加了一堆实验函数   ← reset 之前,你在这条上
40046d1 HEAD@{2}: commit: feat: 添加告别函数
0e539b0 HEAD@{3}: commit (initial): init: 项目骨架

我们看最后这四行。

读法:每一行 = HEAD 曾经“站过”的一个位置。HEAD@{0} 是现在,HEAD@{1} 是一步之前,数字越大越久远。每行开头的编号就是当时所在的 commit。

找到坐标:第一行 reset: moving to 40046d1 说明事故是一次 reset;它下面那行 HEAD@{1}——6bd51bb 加了一堆实验函数——就是出事前的位置,也就是要救回来的提交。编号还在流水账里。

开第二趟时光机,救它回来:

git reset --hard 6bd51bb

验收:git log --oneline 恢复 3 条(init → 添加告别函数 → 加了一堆实验函数),app.py 里实验函数也回来了。

Level5 完成。

你后悔的程度                命令                          改不改历史            已 push 能用吗
文件改崩,还没 commit        git restore <file>            不改                  无所谓(只碰本地未提交改动)
commit 写错/漏文件,没 push   git commit --amend           改                    不能
提交已 push,要撤销          git revert <id>               不改(新增反向提交)    能,唯一正解
本地分支搞砸,想穿越         git reset --hard <id>         改                    不能
连 reset 都用错了            git reflog 找编号 → 再 reset   改                    本地兜底,救命用

三条心法

1. git 从不物理删除 commit,只是“没人指它”——所以才有一层层的后悔药。

2. 改历史的操作(amend/reset)只碰没 push 的;公开历史一律 revert。

3. 真正危险的不是命令猛,而是没 commit 的东西——养成小步多 commit 的习惯。