跳到正文
零到全栈 · 卷 9 · 卷 9

附录C Git急救手册

本合集目录
本章目录

一句话定位:这里不按知识点排,只按"我现在想干什么"排——每一条都告诉你最省事的那一步,以及什么时候千万别走这一步。

什么时候查这个附录

你现在的处境 翻到哪 典型的一句话
提交信息写错、漏了文件、多提交了东西 C-1 "刚 commit 完就发现打错字了"
想把改动退回去,但分不清 restore/reset/revert C-2 "这三个到底哪个会删我的代码?"
站错分支、想删分支、切不过去 C-3 "改了半天,发现一直在 main 上"
文件里冒出 <<<<<<< C-4 "这堆箭头能直接删吗?"
提交不见了、reset 完后悔了 C-5 "我好像把两小时的活弄没了"
错误已经 push 上去了 C-6 "同事已经拉过了,还能改吗?"
密钥、.env 进了仓库 C-7 "删掉文件再提交一次,够不够?"
项 说明
适用版本 Git 2.23 以上(switch/restore 已可用);命令不带小版本号
三条前置习惯 动手前 git status + git log --oneline -5;改写历史前 git branch backup-$(date +%s);分清"只在本地"和"已经 push"
记号 <sha> 用 git log --oneline 里的前七位;<分支> 换成你的分支名

C-1 提交错了

C-1.1 我想改最后一次提交的信息

项 内容
症状 刚 commit 完,发现错字、漏了说明,还没 push
命令 git commit --amend -m "修正后的提交信息"
解释 用新信息重建最后一次提交,旧的被替换;工作区内容不变,提交哈希会变
什么时候别用 已经 push 到共享分支——改写会让本地和远端分叉,必须 force push 才能推上去

C-1.2 我想把漏掉的文件补进最后一次提交

项 内容
症状 提交完发现少了一个文件,不想为此多一条"补文件"的提交
命令 git add 漏掉的文件 && git commit --amend --no-edit
解释 把暂存区并进上一次提交,--no-edit 表示提交信息原样保留
什么时候别用 漏掉的文件被 .gitignore 排除了——先改 ignore 规则,不要用 git add -f 硬塞

C-1.3 我想把某个文件移出最后一次提交(但磁盘上要留着)

项 内容
症状 .env、数据库文件、构建产物被提交了,但本地还要用
命令 git rm --cached .env && git commit --amend --no-edit
解释 只从版本库里移除,磁盘文件不动;同时把 .env 写进 .gitignore,否则下次又进来
什么时候别用 这个文件存在于更早的提交里——amend 只改最后一次,旧提交仍有,要走 C-7

C-1.4 我想改更早的提交信息

项 内容
症状 倒数第三条提交的说明写错了,后面还压着两条
命令 git rebase -i HEAD~3
解释 在打开的列表里把目标行的 pick 改成 reword,保存后逐条改信息;只重写本地历史
什么时候别用 这段历史已经推送且有人在上面工作;改写后所有人都会对不上

C-2 撤销三板斧

先看一张表,把"动了哪一层"看清楚,比背命令有用。

命令 动哪一层 未提交的改动 已提交的改动 已 push 能用吗 典型场景
git restore <文件> 工作区 丢弃 不动 不涉及 改乱了,没提交
git restore --staged <文件> 暂存区 保留 不动 不涉及 多加了一个文件
git reset --soft HEAD~1 分支指针 保留 退回暂存区 要 force 提交早了,想重新组织
git reset HEAD~1 指针 + 暂存区 保留 退回工作区 要 force 想拆成几次提交
git reset --hard HEAD~1 三处全动 丢弃 丢弃 要 force 确定这条不要了
git revert <sha> 新增反向提交 不动 不动 直接 push 公共分支撤错

C-2.1 我想丢掉还没提交的修改

项 内容
症状 文件改乱了,想回到上次提交时的样子
命令 git restore backend/app/main.py
解释 用暂存区(没有就用 HEAD)的内容覆盖工作区,改动立即消失
什么时候别用 改的是未跟踪的新文件——restore 管不到它们,也别顺手用 git clean -fd 全清

C-2.2 我想把文件撤出暂存区,但保留改动

项 内容
症状 git add 加多了,提交前想拆开
命令 git restore --staged backend/app/main.py
解释 只把文件移出暂存区,工作区内容一字不动
什么时候别用 仓库还没有第一次提交(没有 HEAD)时,用 git rm --cached <文件> 代替

C-2.3 我想彻底删掉最后一次提交

项 内容
症状 上一条提交完全错了,改动也不要了
命令 git reset --hard HEAD~1
解释 分支指针、暂存区、工作区一起退回上一次提交,等于那条提交没发生过
什么时候别用 工作区还有别的未提交改动——它们会被一起抹掉;先 git stash 或建备份分支

C-2.4 我想撤销一条已经 push 的提交

项 内容
症状 错误提交已经在远程分支上,别人可能已经拉过
命令 git revert <sha>
解释 生成一条反向提交抵消它,历史不变,可以直接 push,谁都不会分叉
什么时候别用 那条提交是 merge commit 时要加 -m 1;含密钥时要走 C-7,revert 删不掉历史里的密钥

C-3 分支乱了

C-3.1 我改到一半,发现站错分支了

项 内容
症状 在 main 上改了三个文件,才想起应该新开分支
命令 git switch -c feature/notes
解释 未提交的改动会跟着一起切到新分支,main 保持干净
什么时候别用 改动和目标分支有冲突时切不过去;先 git stash,切完再 pop

C-3.2 我切分支被拒绝了

项 内容
症状 报 Your local changes would be overwritten by checkout
命令 git stash push -m "wip" && git switch main && git stash pop
解释 先把改动收进栈,切完分支再取出来;栈里能存多份,用 git stash list 看
什么时候别用 有未跟踪文件会被覆盖时,stash 默认不管它们,要加 -u——先确认那些文件不是你要留的

C-3.3 我想删本地分支

项 内容
症状 分支已经合并,列表里看着乱
命令 git branch -d feature/notes
解释 只删已合并的分支;未合并会拒绝,这就是它的保护
什么时候别用 想用 -D 强删之前,确认那些提交真的不要了——或者你记得住 reflog 能找回来

C-3.4 我想删远程分支

项 内容
症状 远程分支已经合并,想清理
命令 git push origin --delete feature/notes
解释 删的是远程引用,本地同名分支要另外用 git branch -d 删
什么时候别用 还有人在这个分支上工作,或还有未关闭的合并请求;删之前先在团队里说一声

C-4 冲突

C-4.1 我想读懂冲突标记

项 内容
症状 文件里出现 <<<<<<< HEAD、=======、>>>>>>> feature
命令 git status
解释 HEAD 到 ======= 之间是当前分支的版本,之后到 >>>>>>> 是合进来的版本
什么时候别用 别用全局替换把标记一删了事——那等于把两边的代码混在一起,通常连语法都不对

C-4.2 我想把解决完的冲突收尾

项 内容
症状 冲突文件已经手动改好,标记也清干净了
命令 git add 冲突文件 && git commit
解释 add 的语义是"这个冲突我处理完了";merge 用 commit 收尾,提交信息用默认的即可
什么时候别用 rebase 进行中不要用 commit 收尾,要 git add 后 git rebase --continue;用错会多出一条合并提交

C-4.3 我想放弃这次合并

项 内容
症状 冲突太多,或者发现合错了分支
命令 git merge --abort
解释 回到合并开始前的状态,工作区一起恢复
什么时候别用 rebase 中要用 git rebase --abort,cherry-pick 用 git cherry-pick --abort;命令不对会报 no merge in progress

C-5 找回丢失的提交

C-5.1 我想用 reflog 找回一次误操作

项 内容
症状 reset --hard 之后发现删错了,或者提交"不见了"
命令 git reflog,找到目标后 git reset --hard HEAD@{2}
解释 reflog 记录本地 HEAD 的每一次移动,按时间倒序;先看清那一行的动作和提交信息再退
什么时候别用 reflog 只在本地,换机器或重新克隆就没有;默认 90 天过期,别把它当永久备份

C-5.2 我想保住 detached HEAD 里的提交

项 内容
症状 提示 HEAD detached at 加一串哈希,提交完切走就找不到了
命令 git switch -c rescue <sha>
解释 给那个游离提交一个分支名,它才进入引用链,不会被 gc 回收
什么时候别用 已经切走又记不住 sha,先 git reflog 找 HEAD@{n};切走前先建分支,别等丢了再找

C-5.3 我刚做了一次错误的 reset,想回到操作前

项 内容
症状 刚 reset --hard 或合错了分支,还没做别的操作
命令 git reset --hard ORIG_HEAD
解释 ORIG_HEAD 是危险操作前 Git 自动记下的位置,专门为这种反悔准备
什么时候别用 中间又执行过 reset/merge/pull,ORIG_HEAD 已被覆盖;改用 reflog

C-5.4 我想在 reflog 也没有时抢救

项 内容
症状 误操作过去很久,reflog 里找不到那一行
命令 git fsck --lost-found
解释 扫出悬空对象,提交会落在 .git/lost-found/commit/,用 git show 逐个看
什么时候别用 对象已经被 gc 清掉时无效;这也说明"事后抢救"不如"动手前建备份分支"

C-6 已经 push 错了

C-6.1 我想安全地撤销已推送的提交

项 内容
症状 错误提交在远程主分支上,别人可能已经拉过
命令 git revert <sha> && git push
解释 新增一条反向提交,历史只增不改,所有人的仓库都能正常合并
什么时候别用 提交里含密钥——revert 只是再写一次"删除",历史里那把钥匙还在

C-6.2 我想改写已经推送的历史

项 内容
症状 提交信息错、混进了大文件,必须把历史改干净
命令 git push --force-with-lease
解释 前提是已经用 --amend 或 rebase -i 改好;推送时它会比对远端分支是否还是你上次看到的样子,别人推过就拒绝
什么时候别用 共享主分支、有人已基于旧提交工作;改写前必须先通知,否则别人一 pull 就是一堆冲突

C-6.3 我想知道两种 force 差在哪

写法 检查什么 会不会覆盖别人的提交 什么时候用
--force 什么都不检查 会,直接盖掉 只有你一个人用的仓库
--force-with-lease 远端 ref 是否等于你本地记录的远端 ref 别人推过就拒绝 改写自己的分支,默认选它
--force-with-lease=main:<sha> 远端必须正好是 <sha> 不是这个值就拒绝 团队约定或脚本里要精确控制

C-6.4 我把提交推到错误的分支了

项 内容
症状 本该进 feature/notes 的提交,直接推到了 main
命令 git switch feature/notes && git cherry-pick <sha>
解释 把那条提交复制到正确分支;随后在 main 上用 git revert <sha> 撤掉
什么时候别用 错推的是一串相互依赖的提交,逐个 cherry-pick 会漏;改用 git rebase --onto 整段搬

C-7 密钥误提交

C-7.1 我想知道正确的处理顺序

项 内容
症状 .env、私钥、API key 进了提交,甚至已经 push
命令 git rm --cached .env && git commit -m "chore: remove secrets"
解释 顺序是:吊销/换钥 → 更新服务器环境变量 → 重启服务 → 清历史 → 通知协作者。删文件只是第一步
什么时候别用 不要先清历史再换钥——清理要花几分钟,这段时间旧密钥仍然有效,等于没救

C-7.2 怎么把文件从所有历史里删掉

项 内容
症状 密钥存在于很多次旧提交里,git log 一搜就能看到
命令 git filter-repo --path .env --invert-paths
解释 重写全部提交,把该路径彻底移除;需单独安装,且在全新克隆上执行,之后 force push,所有人重新克隆
什么时候别用 仓库是共享的且协调不了时;也不要再用 filter-branch,它慢且容易出错

C-7.3 我想知道为什么清完历史还不够

项 内容
症状 以为 filter-repo 跑完就安全了
命令 git log --all --full-history -- .env
解释 这条能证明旧提交是否真的没了;但远端缓存、fork、CI 日志、构建产物里仍可能留着
什么时候别用 把"清历史"当成补救的全部——密钥一旦离开你的机器,就只能按已泄露处理

密钥这件事只有一条底线:换钥是止血,清历史是打扫。顺序反了,血还在流。


一张纸的决策顺序

先问自己 是 否
提交 push 了吗? 走 C-6,默认 revert 可以放心改写,走 C-1/C-2
改动提交了吗? reset 三选一,看你要不要保留 只有 restore 能救,且不可逆
还记得大概时间吗? git reflog 直接找 git fsck --lost-found 兜底
涉及密钥吗? 先吊销,再谈 Git 按普通错误处理