历史整理与精准移植
整理历史:改写已经存在的提交
前面所有命令都在往后加提交:git add 把改动放进暂存区,git commit 生成新提交,分支指针往前挪一格。 历史只增不改。这一课换方向:修改已经存在的提交。
这件事通常叫“整理历史”,本质是改写历史。Git 的提交对象不可变,所谓改写,不是原地修改旧提交, 而是造出一批新的提交对象替换旧链,再让分支指针指向新链末端。旧对象还在对象库里,只是HEAD不再指向它们。
什么算整理历史
操作 | 做什么 | 对应 rebase 动词 |
|---|---|---|
修改提交信息 | 改主题行或正文,内容不动 |
|
修改提交内容 | 补文件、改一行、拆成多个提交 |
|
合并多个提交 | 把连续几个压成一个 |
|
丢弃某个提交 | 把某次提交从历史上抹掉 |
|
调整提交顺序 | 交换、插入某几个提交 | 改清单行序 |
搬移一段提交 | 把一段提交接到另一个基底上 |
|
共同点:被改动的提交,哈希都会变。因为改的是提交对象内容(树、父提交或提交信息),而哈希由内容算出。 改一个,后面所有提交的哈希连锁变化,因为每个提交都记着父提交的哈希。
改写历史前先确认:这些提交有没有 push 过
本地私有提交(没 push,或只在你自己 fork 的远程)→ 可以放心改写。 已经 push 到共享分支、别人可能已经拉过 → 不要改写,改用 git revert 生成反向提交,历史只增不改。
git rebase 完整用法
git rebase 是所有整理操作的主力工具。它的基本模型是:把一段提交摘下来,接到另一个基底上重新放一遍。 -i(interactive)打开清单,让你在放之前逐条决定怎么处理。
1. 基本变基:把当前分支接到另一个基底上
要解决什么:当前分支从旧位置长出来,现在想让它基于最新的 main 继续。
git log --oneline --graph --all
* 7d3e8f1 (feature/report) add report api
* 6c2b9a0 add report model
| * 4e0b284 (main) add stock clamps
|/
* 3a7d6e0 init project在 feature/report 上执行:
git switch feature/report
git rebase main
Successfully rebased and updated refs/heads/feature/report. git log --oneline --graph --all
* 9c1f3a2 (feature/report) add report api
* 8b0e2d1 add report model
* 4e0b284 (main) add stock clamps
* 3a7d6e0 init project两条提交被摘下来,接到 main 末端重新放了一遍。哈希从 6c2b9a0/7d3e8f1 变成 8b0e2d1/9c1f3a2——父提交变了,哈希必然变。
2. 交互式变基:打开提交清单
要解决什么:不想只是搬移,想逐条决定每个提交怎么处理。
git rebase -i HEAD~3编辑器打开,内容是一张清单,每个提交一行,开头是动词:
pick 5b1a7d3 add report model
pick 6c2b9a0 add report api
pick 7d3e8f1 fix typo # Commands:
# p, pick = 保留
# r, reword = 保留内容,改提交信息
# e, edit = 停下来,允许 amend 内容
# s, squash = 合并进上一个提交,编辑合并后的信息
# f, fixup = 合并进上一个提交,丢弃本提交的信息
# d, drop = 删除清单的行序就是执行顺序。改动词、改行序、保存退出,Git 就按新清单重新造一遍提交。 下面每一节,都是把某一行改成对应动词。
3. reword:改提交信息,内容不动
要解决什么:提交信息写错了,或漏写了“为什么”。
清单里把 pick 改成 reword:
reword 5b1a7d3 add report model
pick 6c2b9a0 add report api
pick 7d3e8f1 fix typo保存退出,Git 为这条提交重新打开编辑器让你写新信息。保存后:
git log --oneline -3
d4e5f6a add report model with nullable fields
9c1f3a2 add report api
8b0e2d1 add report model注意三条哈希都变了。改的是最老的一条,后面每条都要在新的父提交上重放,所以连锁变化。
4. edit:改提交内容,或拆开提交
要解决什么:某次提交漏了一个文件,或一次提交混了两件不相关的事想拆开。
清单里把目标行改成 edit:
pick 5b1a7d3 add report model
edit 6c2b9a0 add report api
pick 7d3e8f1 fix typoGit 重放到这一条时停下,输出:
Stopped at 5fe8149... # add report api
You can amend the commit now, with git commit --amend Once you are satisfied with your changes, run git rebase --continue此时 HEAD 就指向这一条提交。改文件、git add、git commit --amend --no-edit:
git commit --amend --no-edit
[detached HEAD ed639ba] add report api 2 files changed, 2 insertions(+), 1 deletion(-) git rebase --continue
Successfully rebased and updated refs/heads/main.--amend 造一条新提交替换这一条,--continue 接着放清单里剩下的。 这两步之间不 --continue,后面那条永远不会被重放。
拆开一条提交也用 edit:停下后用 git reset HEAD~ 把这条提交的改动退回工作区,再分两次 add + commit,最后 --continue。
5. squash:合并提交,编辑合并后的信息
要解决什么:调试时提交太碎,想压成一次完整改动,并自己写合并后的信息。
三个碎提交:
git log --oneline -3
7d3e8f1 fix typo
6c2b9a0 add report api
5b1a7d3 add report model清单里把后两个改成 squash:
pick 5b1a7d3 add report model
squash 6c2b9a0 add report api
squash 7d3e8f1 fix typoGit 依次应用三个提交,然后在合并处停下,打开编辑器让你写合并后的信息:
# This is a combination of 3 commits.
# This is the 1st commit message: add report model # This is the commit message #2: add report api # This is the commit message #3: fix typo删掉多余的,留一条最终信息,保存退出:
git log --oneline -2
a1b2c3d add report model and api
4e0b284 add stock clamps6. fixup:合并提交,丢弃被合并提交的信息
要解决什么:和 squash 一样是合并,但被合并提交的信息没有保留价值,不想手动编辑。
清单里把后两个改成 fixup:
pick 5b1a7d3 add report model
fixup 6c2b9a0 add report api
fixup 7d3e8f1 fix typo保存退出,Git 直接合并,不再打开编辑器。最终只保留第一行的信息:
git log --oneline -2
b2c3d4e add report model
4e0b284 add stock clampssquash 和 fixup 的唯一差别:squash 让你编辑合并后的信息,fixup 直接丢弃被合并提交的信息,只留内容。
7. drop:删除一条提交
要解决什么:某次提交不该存在,想从历史上抹掉。
两种写法。第一种,把 pick 改成 drop:
pick 5b1a7d3 add report model
drop 6c2b9a0 debug: dump query params
pick 7d3e8f1 fix typo第二种,直接把那一行删掉,效果相同。保存退出后,这条提交从历史消失,后面每条在新的父提交上重放。
8. 调整顺序:改清单行序
要解决什么:提交顺序不理想,想交换或插入。
把 fix typo 挪到 add report api 前面:
pick 5b1a7d3 add report model
pick 7d3e8f1 fix typo
pick 6c2b9a0 add report api保存退出,Git 按新顺序重放。但要注意:重排经常会冲突。
原因:fix typo 的补丁要找 add report api 引入的那行代码当上下文。现在 add report api 被挪到了它后面,补丁找不到落点。输出:
git rebase -i HEAD~3
Auto-merging search.txt
CONFLICT (content): Merge conflict in search.txt
Rebasing (2/3)
error: could not apply 7d3e8f1... fix typo处置两条:解冲突后 --continue,或 --abort 回原顺序换个拆法。
9. --onto:把一段提交搬到新基底
要解决什么:分支从错的地方长出来,只想搬走自己那几条,不想带上别人的提交。
场景:feature/b 从 feature/a 上切出来,但它只该带自己那一条:
git log --oneline --graph --all
* 0f7c060 (HEAD -> feature/b) add export to b
* 8671a01 (feature/a) add sort corner
* 8747ce2 add page filter
| * e49aeef (main) add health check
|/
* 6c2a18f add stock endpoint普通 git rebase main 会把 feature/b 上三条全搬走,包括本该留在 feature/a 的两条。 用三段式只搬自己那一条:
git rebase --onto main feature/a feature/b
Successfully rebased and updated refs/heads/feature/b. git log --oneline main..feature/b
4f6fffc add export to b git log --oneline feature/a
8671a01 add sort corner
8747ce2 add page filter
6c2a18f add stock endpoint三个参数读作:把 feature/a..feature/b 这一段(feature/b 有、feature/a 没有的提交)搬到 main 上。
参数位置 | 含义 | 例子里的值 |
|---|---|---|
| 新基底 |
|
第二个 | 旧基底(从这里之后开始搬) |
|
第三个 | 要搬的分支 |
|
搬完 feature/a 一个没动,两条还在原处;main..feature/b 从三行变一行。
10. 冲突处理:--continue / --skip / --abort
要解决什么:rebase 途中停下来,不知道该往前、跳过、还是退出。
先看停在什么状态。main 把 conf.txt 的端口从 8080 改成 9090,feature/env 改成从环境变量读,rebase 撞上:
git rebase main
CONFLICT (content): Merge conflict in conf.txt
Rebasing (1/2)
error: could not apply fd3038b... read port from env此刻 HEAD 不在你分支上,而是停在“已重放好的那部分”,也就是 main 的最新提交:
git branch
* (no branch, rebasing feature/env) feature/env main git rev-parse --short HEAD main
2687f00
2687f00HEAD 和 main 指向同一个提交,所以两条命令打出同一个哈希。
冲突文件里两边是谁:
cat conf.txt
<<<<<<< HEAD
port=9090
=======
port=$PORT
>>>>>>> fd3038b (read port from env)标记 | 这一边是 |
|---|---|
|
|
| 你的 |
merge 和 rebase 的 HEAD 方向是反的
merge 时 HEAD 指向你自己的分支,<<<<<<< HEAD 那边是你的内容。 rebase 时 HEAD 指向对方,<<<<<<< HEAD 那边是对方的内容。 方向弄反,就会把对方的内容当成自己的删掉。
出口一:--continue。把文件改成最终内容,git add 标记为已解决,再继续:
git add conf.txt
git rebase --continue
[detached HEAD 662e5d7] read port from env
Rebasing (2/2)
Successfully rebased and updated refs/heads/feature/env.没 add 就 continue,它会拒绝:conf.txt: needs merge。add 是标记动作,不看文件里还有没有冲突标记。
出口二:--skip。丢掉当前这条,接着放下一条:
git rebase --skip
CONFLICT (content): Merge conflict in conf.txt
Rebasing (2/2)
error: could not apply 183bfcc... add default port fallback--skip 不是出口,只是往前挪一步。下一条往往也依赖被丢掉的内容,照样撞车。 清单空了不代表结束,得把冲突解完才算。
出口三:--abort。整场退掉,回到敲 git rebase 之前:
git rebase --abort git status -sb
## feature/env cat conf.txt
port=$PORT
fallback=8080成功时什么都不打印。分支名回来了,文件回到撞车之前的版本。没有 rebase 在跑时敲它:fatal: no rebase in progress。
11. --autosquash:自动整理 fixup 提交
要解决什么:发现某条老提交漏了东西,先补一个 fixup 提交,之后自动合并回目标。
改完文件、git add,提交时带上目标那条的哈希:
git commit --fixup=f31ca82
[main dc031a8] fixup! add search endpoint git log --oneline
dc031a8 fixup! add search endpoint
ee32438 add report endpoint
f31ca82 add search endpoint说明固定写成 fixup! 加原说明。整理时加 --autosquash,Git 自动把它排到目标后面、动词改成 fixup:
git rebase -i --autosquash HEAD~3 # 清单自动变成:
pick f31ca82 # add search endpoint
fixup dc031a8 # fixup! add search endpoint
pick ee32438 # add report endpoint Successfully rebased and updated refs/heads/main. git log --oneline
0be4dbd add report endpoint
0cac15a add search endpoint人不用动清单。默认不自动排,加 git config rebase.autosquash true 可让它成为默认行为。
和 rebase 同源的工具
cherry-pick:只摘别人分支上的一条
要解决什么:另一条分支上有多条提交,只要其中一条。
git log --oneline --graph --all
* 55bc383 (feature/export) add export sample row
* e128bb8 add csv export
| * f31ca82 (HEAD -> main) add search endpoint
|/
* 6c2a18f add stock endpoint git cherry-pick e128bb8
[main ecdfba3] add csv export 1 file changed, 1 insertion(+) create mode 100644 export.csv把一条提交的补丁摘过来,在当前位置重新提交一遍——和 rebase 重放一条提交是同一件事。 说明和原来一样,哈希是新的。
只要改动先进暂存区、检查完再提交,加 -n:
git cherry-pick -n 55bc383 git status -s
M export.csv一段范围一次摘完:git cherry-pick e128bb8~1..55bc383。a..b 不含 a,所以起点写 ~1。
stash:手上改了一半要切走
要解决什么:工作区有未提交改动,但要切分支或 rebase,不想带着走。
git status -s M search.txt
?? notes.txt git stash
Saved working directory and index state WIP on main: f31ca82 add search endpoint git status -s
?? notes.txtstash 把已跟踪文件的改动收进抽屉,未跟踪的 notes.txt 原地不动。 拿回来用 git stash pop;未跟踪的也要收,加 -u;给抽屉起名,加 -m "说明"。
add -p:一个文件里只提交一块
要解决什么:一个文件里两处改动隔得远,只想提交其中一处。
git add -p
@@ -1,5 +1,5 @@ q=
-limit=10
+limit=20
(1/2) Stage this hunk [y,n,q,a,d,s,e,?]? y
@@ -7,4 +7,4 @@
-debug=0
+debug=1
(2/2) Stage this hunk [y,n,q,a,d,s,e,?]? nGit 把改动切成块(hunk),一块一块问。y 收、n 不收、s 再切小、e 手动编辑、q 不干了。 之后 git status -s 从 M 变成 MM:左列是已进暂存区的,右列是还没进的。
改写历史之后,推不上去
要解决什么:提交已经 push 过,改写后再 push 被拒。
git push ! [rejected] main -> main (non-fast-forward)原因:改写过之后,本地的 70e97fb 和远程的 bdc1da1 是两条平行线,不是一条线上的前后。 明知是改写,用 --force-with-lease:它只在“远程还在我以为的那个位置”时才覆盖。
git push --force-with-lease + bdc1da1...70e97fb main -> main (forced update)+ 是强制更新的标记。如果同事在你之前推过,lease 会替你拦:
git push --force-with-lease ! [rejected] main -> main (stale info)stale info 的意思是:本地记录的 origin/main 还是旧值,远程已经不是了。先 git fetch 看差了什么,再决定推不推。
要抵消共享分支上的改动,用 revert 不用 reset
已经进了共享分支的内容,反向操作是 git revert:它生成一条内容相反的新提交,历史只增不改,别人拉下来不会分叉。 改写历史留给“还没推上去”的那一段。
什么时候不该整理
按顺序问三个问题,任何一个是「是」就停手:
这条提交推上去了吗?推上去就不重排,用
merge往上接,或者用revert反向抵消。有人基于它干活吗?不确定就先
git fetch,看git log main..origin/main再决定。只是本地、还没推的特性分支?随便整理 —— 它就是为整理而存在的。
还有一个更省事的做法:把整理前移。--fixup 让你边写边标记,add -p 让你提交前先分块 —— 大部分「需要整理的历史」在提交那一刻就能避免。
这一课的动作分三类:换基底(rebase、--onto)、重写清单里的提交(squash、 fixup、reword、edit、drop)、把别处的改动搬过来(cherry-pick)。 stash 和 add -p 不碰历史,管的是提交之前。
这些命令做的都是同一件事:造新的提交对象,把分支指针挪过去,旧对象留在 .git 里没人指。 这些对象到底长什么样、哈希怎么算出来、reflog 为什么能捞回来 —— 下一课是 Git 内部原理与底层命令。