Git中rebase的常规使用

发表于 2020-01-09 更新于 2024-03-06 分类于 git

git

公司从svn版本管理切换成了git，Android Studio（Intellij IDEA）也可以较好的支持git，相当方便。git有一个特别强大的命令，那就是rebase，这篇blog就记一下git rebase的一些使用。

官方文档

https://git-scm.com/docs/git-rebase

一个不错的操作模拟

https://learngitbranching.js.org/

git rebase的常用操作

本文不另辟捷径，官方文档讲的很详细，就挑几个官方的例子翻译一下。

案例1 ：

1
2
3

      A---B---C topic
     /
D---E---F---G master

1 2	git rebase master git rebase master topic

上面两条命令，执行其中的一条就可以，执行以后。其实就是git rebase upstream branch

1
2
3

              A'--B'--C' topic
             /
D---E---F---G master

案例2：–onto的使用

1 2	git rebase [-i \| --interactive] [<options>] [--exec <cmd>] [--onto <newbase> \| --keep-base] [<upstream> [<branch>]]

o---o---o---o---o  master
     \
      o---o---o---o---o  next
                       \
                        o---o---o  topic

1	git rebase --onto master next topic

执行的结果为

o---o---o---o---o  master
    |            \
    |             o'--o'--o'  topic
     \
      o---o---o---o---o  next

这里–onto的后面有三个参数（其实属于–onto的就一个）

参数1：要跟随在哪个commit，可以是分支名，也可以是commit的 Revision Number
参数2：after-this-commit 意思是，从这个commit之后的开始算，这个commit是不算的
参数3：要操作的最后一个commit，这个本身是要算进去的。

复制一段commits到另一个分支（as应该不支持）

1
2
3

A---B---C---D---E  master
     \
      F---G---H---I---J---K---L---M  topic

比如想把K L M的提交copy到master上，那么可以使用命令

1
2
3

git checkout master
git rebase --onto E J M
git rebase HEAD master

结果为

1
2
3

A---B---C---D---E---K‘---L’---M‘  master
     \
      F---G---H---I---J---K---L---M  topic

注意这里一定要git rebase HEAD master，因为执行了第二条rebase后，只是复制了一份commit过去，需要处理一下master和HEAD。

案例3：合并多条commit为一条

1	git rebase -i <after-this-commit>

执行上述命令后，会让你配置每一项的处理方式

pick ：不做任何修改；
reword：只修改提交注释信息；
edit：修改提交的文件，做增补提交；
squash：将该条提交合并到上一条提交，提交注释也一并合并；
fixup：将该条提交合并到上一条提交，废弃该条提交的注释；

关于Android Studio

AS内置的插件可以满足大部分功能，按command + 9可以唤出来log tab
附上操作指南：
https://www.jetbrains.com/help/idea/edit-project-history.html

我试了试，最终在as里没有找到 –onto 复制一段commits的方式，因为第三个参数必须得选branch，在stackoverflow里，找到一处资料。对比可以看到，如果和上述一段commits，是缺少参数的，所以这里得用命令行了。实际中，也劝大家尽量不要用这种方式。

The rebase dialog in IntelliJ 12.1 uses the most general version of the rebase command:
1
git rebase [-i] [--onto newbase] [upstream] [branch]
where IntelliJ’s “Onto” field corresponds to --onto newbase, IntelliJ’s “From” field corresponds to “upstream” and IntelliJ’s “Branch” field corresponds to “branch”.

In above git rebase command all parameters are optional, while in IntelliJ they are not. This means that you have to take your git rebase command and express it using the general form shown above.

Note that what you actually do with the arguments of the rebase command is define a range of commits that will be replayed in a new target location. Generally, the range is upstream..branch. If you are not familiar with commit ranges you should read up on them.

Let’s look at your example and assume that you are on branch “branch”:
1
git rebase -i HEAD~4
Let’s first figure out which is the range. Since you have only one argument, HEAD~4, this corresponds to upstream, i.e. the range is HEAD~4..branch or in other words HEAD~4..HEAD on branch “branch”. The question is now which is your –onto target. If you avoid --onto, then git assumes that your upstream is also your --onto.

This yields:
1
git rebase -i --onto HEAD~4 HEAD~4 branch
and now you can fill in IntelliJ’s rebase dialog using

Onto: HEAD~4

From: HEAD~4

Branch: branch

IntelliJ actually forces you to think first and identify your range and target, which looks more complicated, but which prevents you from doing a rebase without understanding what the result will be.

https://stackoverflow.com/questions/14608812/how-to-do-interactive-rebase-with-intellij-idea

注意AS中，也可以勾选-i参数

如果是只有一条提交记录，通常用cherry-pick很方便，rebase可以用来处理多条commits的时候。当然，你也可以把commit先执行squash，再执行cherry-pick。