Git-rebase 黑魔法之打磨 commit 颗粒度

港控/mmm° 2022-05-30 07:37 225阅读 0赞

--------------------

## title: Git-rebase 黑魔法之打磨 commit 颗粒度   date: 2018-02-27 18:25:01   tags: ##

又是一个 rebase 黑魔法篇

# 写在前面 #

今天的主题是 rebase 的第二个黑魔法-交互式 rebase,与 rebase 用做两个分支见的遍及合并不同，交互式一般用于同一个分支中的提交整理。从命令上看，两者是 `rebase` 和 `rebase -i`的区别。

需要特别说明的是，`rebase -i`的 GET 也会让你的帅气值+10～

# rebase -i 开启黑暗世界 #

`rebase -i`叫交互式 rebase ,那它交互的是什么呢？是提交。

`rebase -i` 的第一步，就是选定交互的提交，或者说提交们，这是一个范围。

例如下面的命令，就是选定\[当前提交,当前往前数三个提交)，这是一个左闭右开的集合。

git rebase -i HEAD^^^

一个 enter 按下去，就开启了黑暗世界,进入了 rebase 交互的页面，如下图：

![0de895d14c1c531b3cf36a1bb5d847aa.png][]

从这张图中，你可以分两个部分看：

1.  主要内容：选定的提交们，以及对它们的处理。
2.  带`#`的注释内容：关于对这些提交你能操作的命令，理解了它们，就可以开心地为所欲为了。

先看注释内容，理论知识大概掌握先：

**p,pick**  
使用该提交，也是默认操作，这个从上面的编辑区域可以看出。这个命令的含义是拿到这个命令，但是什么都不做。

**r,reword**  
拿到提交，修改提交的提交信息。

**e,edit**  
拿到提交，修改这个提交的内容。使用这个命令的时候，rebase 操作会停在操作提交处，等待修改完毕，使用`git add .`和 `git commit --amend`修改提交，`git rebase --continue`继续 rebase 进程。

**s,squash**  
这个命令很厉害的，可以将使用这个命令的提交与它的父提交融合为一个提交。

**f,fixup**  
和 squash 命令的作用一样，不同的是，squash 命令会把融合的提交的提交信息都保存融合后的提交信息中，但是 fixup 会放弃被融合的提交。

**d,drop**  
删除提交

**x,exec**  
这个不常用，我不是很懂，你若是有兴趣，可以自行研究。

知道了命令，现在看怎么用：

第一步：编辑操作命令

确定要操作的 commit,确定操作命令后，将目标提交的 `pick` 修改成成对应的操作命令。不需要处理的默认 `pick`就好，不要删除，删除的意思是要移除这个提交，和 `drop` 是一个意思。

需要明白的是，编辑区默认的提交顺排列序是按提交历史上的顺序排列的，由前到后，顺序执行，所以顺序不要颠倒。不然你想想，改完最后一个提交之后，再修改第一个提交，历史都散开不能串成一串了。

![bd47622d6998c7b1b6bfdd9145eb0ecc.png][]

![c3b58841f2a3789d8b2917208f50b29d.png][]

第二步：确定执行

保存退出交互页面就开始执行 rebase 了。顺利的话，直接执行成功，发生冲突，解决之后，执行 `git rebase --continue`继续进行，直至执行成功。

![5bbb8db0ff58e54539ea854b79289504.png][]

# 小例子：用 reword 和 fixup 打磨提交颗粒 #

关于 commit 的颗粒度，提交频率高，就细一点，例如修改了一个文件就打个提交；提交频率低，就粗一点，例如这整个模块完成了，才有一次最终版本的提交。关于颗粒度的粗细把握，见仁见智，这里不做讨论。我想说的是，如何去形成你的颗粒度。

因为真实开发中，我看到太多没有一点意义提交了，放张我刚翻出来的截图，这是远程仓库中一个项目的部分提交历史。

![0836906b09344506e8fb2d752b8f31a9.png][]

我几乎能想象出当初娃子写推送的烦躁感，虽然很好玩，但是这个提交毫无意义，看的人，根本不知道你提交了些什么，非常不利于后期维护。合理的做法是，推动在远程之前，现在在自己的本地分支上把提交历史理清楚。

例如下图，就可以用 `reword`和 `fixup` 命令完成从前到后的变化。

![66a58e9985f2ce74e3f0eacc860f7bb1.png][]

下面开始构建测试场景

// 切换到GitDemo目录下,并初始化Git
    cd .../GitDemo  
    git init  
    
    //创建初次提交 C1
    touch rebase.txt
    git add .
    git commit -m '初次提交'  
    
    
    //创建提交 C2
    git checkout -b develop
    touch A.txt
    git add .
    git commit -m "详情页布局完成一半"
    
    
    //创建提交 C3
    touch B.txt
    git add .
    git commit -m "详情页布局结束"
    
    //创建提交 C4
    touch B.txt
    git add .
    git commit -m "修复了2个bug"

分析：

1.  改动范围有 C2，C3，C4，确定使用 `HEAD^^^`
2.  要达到如上场景，要把 C2 和 C3 合并为一个提交 C5，`fixup` 和 `squash`满足要求，但 C5 的提交未保存 C3 的信息，那确定 C3 使用 `fixup` 操作。
3.  C5 的提交信息 C2 和 C3 都不同，那么 C2 需要先把提交信息改成合并后的提交信息， C2 需要 `reword` 操作。
4.  C4 的提交信息修改，C4 需要 `reword` 操作。

//开始 rebase -i
    git rebase -i HEAD^^^

![d092bb1e0bfd36fe0168f87f0bfdff0a.png][]  
![9b8469a120a8bb846f03e3c70f0e13ff.png][]

执行成功，现在通过 `git log`查看操作分支的历史，和操作前的对比，确认已经成功整理了 commit 历史，大功告成！同时也注意到 `rebase` 后的提交 SHA1 值发生变化，证明是一个新的提交。

![0a81c439fb99bc707c30fd2d67bb599f.png][]

# 施黑魔法的时机是什么？ #

上面演示了 `reword` 和 `fixup`，其他的你可以自己试试，漫漫开发中生涯中，说不准什么时候就用到了，施黑魔法的时机有很多，例如：

*  之前的提交信息有个错字，你的强迫症犯了（reword）
 *  发现之前有个提交中的修改，有点问题，但是不想打个比较没意义的补丁提交（edit）
 *  等等

更多的场景等你发现。

# 写在后面 #

其实 rebase 的用法还有很多，而且个个都是堪称为黑魔法级别的操作，例如还可以将一个 commit 分离为俩的，真是跪服了！建议没有需求就不要骚操作了，特别是在工作项目上，有点危险。汝若有兴趣，可轻移莲步到 [git-rebase 官方文档][git-rebase]。

合并为线性历史和整合提交历史，是 rebase 比较实用两个功能，可以保持一个清晰的提交历史，并让每个提交都有意义，在代码的长期维护上有好处。

我的做法是：在私人的功能开发分支使用 `rebase -i` 保持颗粒粗细合适提交，使用 `rebase`合并到 develop 分支，保持简洁线性历史，但是 develop 合并到 master,使用 `merge`，并加上 `no-ff` 可以看到合并操作的记录。暂时的功能开发分支没必要保持合并记录，长期分支合并操作记录还是非常有必要的。

# 欢迎订阅我的Git系列文章 #

*  [ 01. 请回答：Git是什么？][01. _Git]
 *  [ 02. Git常用命令一日游活动][02. Git]
 *  [ 03. Git三大特色之Branch(分支)][03. Git_Branch]
 *  [ 04. Git三大特色之Stage(暂存区)][04. Git_Stage]
 *  [ 05. Git三大特色之WorkFlow(工作流)][05. Git_WorkFlow]
 *  [ 06. Git-你好, HEAD 同学][06. Git-_ HEAD]
 *  [ 07. Git-用 cherry-pick 挑好看的小樱桃][07. Git-_ cherry-pick]
 *  [ 08. Git-rebase 黑魔法之打造完美的线性历史][08. Git-rebase]
 *  [ 09. Git-rebase 黑魔法之打磨 commit 颗粒度][09. Git-rebase _ commit]
 *  [ 10. Git-少年，你想学回滚吗？想撤销文件修改吗？][10. Git-]
 *  [ 11. Git-移动记录仪 & 贴心小棉袄 reflog][11. Git-_ _ _ reflog]
 *  [ 12. Git-丢失的 commit 是真的消失了吗？][12. Git-_ commit]
 *  [ 13. Git-叹为观止的 log 命令 & 其参数][13. Git-_ log _ _]
 *  [ 14. Git-送娃子们一本关于如何自学 Git 的秘籍][14. Git-_ Git]

--------------------

欢迎关注个人微信公众号「浅浅同学的开发笔记」，最新的博客，好玩的事情，都会在上面分享，期待与你共同成长。

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzMyNDUyNjIz_size_16_color_FFFFFF_t_70_pic_center]

[0de895d14c1c531b3cf36a1bb5d847aa.png]: /images/20220530/c72705a4f02b4abfad42e05e3c14c47d.png
[bd47622d6998c7b1b6bfdd9145eb0ecc.png]: /images/20220530/608ae321ee0849d9a5fd60292d819597.png
[c3b58841f2a3789d8b2917208f50b29d.png]: /images/20220530/8cb181732a274b26b5f0bbccb33cb94d.png
[5bbb8db0ff58e54539ea854b79289504.png]: /images/20220530/7f6074758b424444bc625c06b4fc02b3.png
[0836906b09344506e8fb2d752b8f31a9.png]: /images/20220530/d42e216d59104ae3b6185ad5534a2379.png
[66a58e9985f2ce74e3f0eacc860f7bb1.png]: /images/20220530/7467fc2e99924d01b251401775aa83fc.png
[d092bb1e0bfd36fe0168f87f0bfdff0a.png]: /images/20220530/371e8d69e00c4b878b58aa03dfae64cf.png
[9b8469a120a8bb846f03e3c70f0e13ff.png]: /images/20220530/636477b6a35942d08b24ffc5e3b8d2bd.png
[0a81c439fb99bc707c30fd2d67bb599f.png]: /images/20220530/82b3ed97903e4b20a064cb037cd6163d.png
[git-rebase]: https://git-scm.com/docs/git-rebase
[01. _Git]: http://blog.csdn.net/qq_32452623/article/details/78276451
[02. Git]: http://blog.csdn.net/qq_32452623/article/details/78276474
[03. Git_Branch]: http://blog.csdn.net/qq_32452623/article/details/78355976
[04. Git_Stage]: http://blog.csdn.net/qq_32452623/article/details/78417609
[05. Git_WorkFlow]: http://blog.csdn.net/qq_32452623/article/details/78905181
[06. Git-_ HEAD]: http://blog.csdn.net/qq_32452623/article/details/79415990
[07. Git-_ cherry-pick]: http://blog.csdn.net/qq_32452623/article/details/79449534
[08. Git-rebase]: http://blog.csdn.net/qq_32452623/article/details/79459842
[09. Git-rebase _ commit]: http://blog.csdn.net/qq_32452623/article/details/79475057
[10. Git-]: http://blog.csdn.net/qq_32452623/article/details/79521461
[11. Git-_ _ _ reflog]: http://blog.csdn.net/qq_32452623/article/details/79534832
[12. Git-_ commit]: http://blog.csdn.net/qq_32452623/article/details/79551429
[13. Git-_ log _ _]: http://blog.csdn.net/qq_32452623/article/details/79599503
[14. Git-_ Git]: http://blog.csdn.net/qq_32452623/article/details/79619798
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzMyNDUyNjIz_size_16_color_FFFFFF_t_70_pic_center]: /images/20220530/13a2101612ad4a4780420b9de80f61b2.png