一句话定位:这里不按知识点排,只按"我现在想干什么"排——每一条都告诉你最省事的那一步,以及什么时候千万别走这一步。
什么时候查这个附录
| 你现在的处境 |
翻到哪 |
典型的一句话 |
| 提交信息写错、漏了文件、多提交了东西 |
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 |
按普通错误处理 |