提交历史乱成一团?用 rebase 把它整理成一条直线
提交历史乱成一团?用 rebase 把它整理成一条直线
做后端开发,提交历史这东西平时没人看,一到 Code Review 就原形毕露:我有一次提了个 PR,里面混着"fix typo"、“wip”、“再改一下"十几条提交,review 的同事直接说"看不懂你到底改了什么”。从那以后我养成了习惯:合并进主分支之前,先用 rebase 把历史整理干净。这篇写给还在用"能跑就行"的提交方式的人,讲清楚 rebase 最实用的两个用法。
先说清楚:rebase 是干什么的
一句话:rebase 是把你的提交"挪"到另一个基底上,并按顺序重新" replay"一遍。最常见的场景是你从 main 切了个分支开发了三天,期间 main 被别人推了十几个提交,你的分支落后了。这时候有两个选择:merge 会产生一个"Merge branch ‘main’"的合并提交,历史变成一张网;rebase 则是把你的提交一个个搬到最新的 main 顶端,历史还是一条直线,干净得像刚写出来的。
用法很简单,先切回你的分支:
git checkout feature/login
git rebase main
如果中间有冲突,Git 会停下来让你解决,解决完 git add 之后 git rebase --continue 继续。全部搬完,你的提交就整齐地排在了最新 main 的后面。想中途放弃,随时 git rebase --abort,一切回到开始前。
整理自己的提交:交互式 rebase
比"挪基底"更常用的是整理自己分支里的提交。比如你开发一个登录接口,顺手修了三个 typo、改了两次配置,最后历史里躺着七八条零碎提交。合并前把它们压成一两条有意义的提交,review 的人会感谢你。
git rebase -i HEAD~5
这会打开一个编辑器,列出最近 5 条提交,每条前面有个 pick。把想合并进上一条的提交前面的 pick 改成 squash(或简写 s),保存退出,Git 会让你再编辑一次最终的提交信息。想彻底删掉某条提交(比如调试时误提交的日志代码),把那行直接删掉就行。想调整顺序,直接拖动行的位置。
我自己的规矩是:一个 PR 对应一个逻辑改动,提交信息写清楚"做了什么、为什么"。比如登录接口的提交写成"feat: 邮箱密码登录接口,密码 bcrypt 加密存储",而不是"login ok"。
黄金法则:别对已经公开的提交 rebase
rebase 会改写提交的哈希,相当于把旧提交"换掉"。如果这条分支只有你一个人在用,随便改;但如果已经推到远程、别人也基于它在开发,你一 rebase,对方的本地历史就对不上了,轻则多一堆冲突,重则丢提交。
所以记住两条红线:已经合并进 main 的提交不要 rebase;多人协作的公共分支不要 rebase。只整理自己还没合并的本地分支。实在需要在已推送的分支上整理,推的时候必须用 git push --force-with-lease(带 lease 的强制推送,远程有人先推了会拒绝,比裸 --force 安全得多)。
我踩过的一个坑
有一次我在 rebase 过程中解决冲突,改完顺手 git commit 而不是 git add,结果多出一个"解决冲突"的提交,历史又脏了。记住:rebase 停下来等你解决冲突时,解决完只 git add 相关文件,然后 git rebase --continue,不要自己 commit。Git 会在继续的时候自动生成对应的提交。
写在最后
rebase 不是什么高深技巧,它就是"整理历史"的工具:同步主分支用 git rebase main,整理自己的提交用 git rebase -i。配合"一个提交只做一件事、提交信息写清楚为什么"的习惯,你的提交历史会从"没人敢看"变成"新人入职先读它就能看懂项目演进"。合并之前花两分钟整理,Code Review 的时候省下的时间远不止两分钟。
- 点赞
- 收藏
- 关注作者
评论(0)