看日记学git

《看日记学git》之三十一

原创文章属于《Linux大棚》博客,博客地址为http://roclinux.cn。文章作者为rocrocket。
为了防止某些网站的恶性转载,特在每篇文章前加入此信息,还望读者体谅。

===

[正文开始]

在之前的《git尚待解决的问题汇总》中,第二个待解决的问题是git-rebase命令。这个命令是比较难的一个,想搞定它绝非易事。我努力叙述的清晰些,如果您还是不太懂,那就直接给我发邮件吧,我会很乐意和您交流关于git以及博客里任何文章的心得的,take it easy!(我的邮件地址我相信你能找到^_^)

命令格式

我们先来看看git-rebase的命令格式:

git rebase [-i | –interactive] [options] [–onto <newbase>]  <upstream> [<branch>] git rebase [-i | –interactive] [options] –onto <newbase>  –root [<branch>] git rebase –continue | –skip | –abort

从命令格式,可以看到git-rebae命令至少需要一个参数,那就是<upstream>,这个参数可以是一个分支名称,也可以是一次有效的commit。

一个小地方

在你决定学习这个命令,首先有一个小地方你应该注意,那就是如果git-rebase后面加上了参数<branch>,那么 git-rebase会在任何其他动作之前先执行git checkout <branch>,如果没有加参数<branch>,那么git-rebase会针对当前分支来做动作。

命令用处

git-rebase命令主要用在从上游分支获取最新commit信息,并有机的将当前分支和上游分支进行合并。

这是只言片语的介绍,可能读者并不能了解它的用途和好处。

还是要用例子说话。我们假设主分支为master,在开发过程中生成一个新分支topic。master称为topic的上游分支。

例子开始:

[rocrocket@wupengchong git-study]$ cd rebase
[rocrocket@wupengchong rebase]$ ls
[rocrocket@wupengchong rebase]$ vi roc.c
[rocrocket@wupengchong rebase]$ cat roc.c
int main()
{
printf(“master:001”);
return 0;
}
[rocrocket@wupengchong rebase]$ git init
Initialized empty Git repository in /rocrocket/career/programming/git-study/rebase/.git/
[rocrocket@wupengchong rebase]$ git add .
[rocrocket@wupengchong rebase]$ git commit -m “master:001”
Created initial commit 2d89602: master:001
1 files changed, 5 insertions(+), 0 deletions(-)
create mode 100644 roc.c
[rocrocket@wupengchong rebase]$ git log
commit 2d89602d0c9955824df0d2c023e447f5d98d863a
Author: rocrocket <wupengchong@gmail.com>
Date:   Mon Nov 17 15:26:40 2008 +0800

master:001
[rocrocket@wupengchong rebase]$

到此,我们已经在master分支完成了一个commit。

[rocrocket@wupengchong rebase]$ vi roc.c
[rocrocket@wupengchong rebase]$ git commit -a -m “master:002”
Created commit 41b3d1c: master:002
1 files changed, 1 insertions(+), 0 deletions(-)
[rocrocket@wupengchong rebase]$ cat roc.c
int main()
{
printf(“master:001”);
printf(“master:002”);
return 0;
}
[rocrocket@wupengchong rebase]$ git log
commit 41b3d1cfaae0184bb8e5f27a165d51cc23867413
Author: rocrocket <wupengchong@gmail.com>
Date:   Mon Nov 17 15:28:01 2008 +0800

master:002

commit 2d89602d0c9955824df0d2c023e447f5d98d863a
Author: rocrocket <wupengchong@gmail.com>
Date:   Mon Nov 17 15:26:40 2008 +0800

master:001
[rocrocket@wupengchong rebase]$

到此为止,我们已经在master分支完成了两次commit的提交。

现在的分支结构是这样的,请读者记清楚:

master:001 — master:002   (master)

好,我们继续要做的事情就是建立一个新的分支topic。

[rocrocket@wupengchong rebase]$ git branch
* master
[rocrocket@wupengchong rebase]$ git branch topic
[rocrocket@wupengchong rebase]$ git branch
* master
topic
[rocrocket@wupengchong rebase]$ git checkout topic
Switched to branch “topic”
[rocrocket@wupengchong rebase]$ git branch
master
* topic
[rocrocket@wupengchong rebase]$

好了,我们已经成功建立了topic分支,并且已经转移到了topic分支。

接下来,topic上面的开发情况如下:

[rocrocket@wupengchong rebase]$ vi roc.c
[rocrocket@wupengchong rebase]$ git commit -a -m “topic:001”
Created commit d599b54: topic:001
1 files changed, 1 insertions(+), 0 deletions(-)
[rocrocket@wupengchong rebase]$ vi roc.c
[rocrocket@wupengchong rebase]$ git commit -a -m “topic:002”
Created commit 3f4b17f: topic:002
1 files changed, 1 insertions(+), 0 deletions(-)
[rocrocket@wupengchong rebase]$ cat roc.c
int main()
{
printf(“topic :002”);
printf(“topic :001”);
printf(“master:001”);
printf(“master:002”);
return 0;
}
[rocrocket@wupengchong rebase]$ git log
commit 3f4b17fe3b5d277771770c0515e75f04e783ad14
Author: rocrocket <wupengchong@gmail.com>
Date:   Mon Nov 17 15:49:24 2008 +0800

topic:002

commit d599b54336ad96b8e09ef92e371a09a25e6d0c11
Author: rocrocket <wupengchong@gmail.com>
Date:   Mon Nov 17 15:48:58 2008 +0800

topic:001

commit 41b3d1cfaae0184bb8e5f27a165d51cc23867413
Author: rocrocket <wupengchong@gmail.com>
Date:   Mon Nov 17 15:28:01 2008 +0800

master:002

commit 2d89602d0c9955824df0d2c023e447f5d98d863a
Author: rocrocket <wupengchong@gmail.com>
Date:   Mon Nov 17 15:26:40 2008 +0800

master:001
[rocrocket@wupengchong rebase]$

可知,自从建立并切换到topic分支后,topic又进行了两次commit提交,每次分别加入了一行代码。

此时,分支结构应该是这样的:

                topic:001 --- topic:002  (topic)
                   /
master:001 --- master:002   (master)

这个图已经很清晰了,可以看出分支的走向。

接下来,master分支也有自己的进度,如下:

[rocrocket@wupengchong rebase]$ git checkout master
Switched to branch “master”
[rocrocket@wupengchong rebase]$ git branch
* master
topic
[rocrocket@wupengchong rebase]$ vi roc.c
[rocrocket@wupengchong rebase]$ git commit -a -m “master:003”
Created commit 91a7ffc: master:003
1 files changed, 1 insertions(+), 0 deletions(-)
[rocrocket@wupengchong rebase]$ vi roc.c
[rocrocket@wupengchong rebase]$ git commit -a -m “master:004”
Created commit b81fbc3: master:004
1 files changed, 1 insertions(+), 0 deletions(-)
[rocrocket@wupengchong rebase]$ cat roc.c
int main()
{
printf(“master:001”);
printf(“master:002”);
printf(“master:003”);
printf(“master:004”);
return 0;
}
[rocrocket@wupengchong rebase]$ git log
commit b81fbc3be5c7bd1fdef72820c29e2c67590f4b03
Author: rocrocket <wupengchong@gmail.com>
Date:   Mon Nov 17 15:55:23 2008 +0800

master:004

commit 91a7ffc73e6320a86b10849061efd672f47fd5bd
Author: rocrocket <wupengchong@gmail.com>
Date:   Mon Nov 17 15:55:06 2008 +0800

master:003

commit 41b3d1cfaae0184bb8e5f27a165d51cc23867413
Author: rocrocket <wupengchong@gmail.com>
Date:   Mon Nov 17 15:28:01 2008 +0800

master:002

commit 2d89602d0c9955824df0d2c023e447f5d98d863a
Author: rocrocket <wupengchong@gmail.com>
Date:   Mon Nov 17 15:26:40 2008 +0800

master:001
[rocrocket@wupengchong rebase]$

可以看到,master分支也完成了两次commit提交,每次分别添加了一行代码。

截止此时,分支结构为:

                topic:001 --- topic:002  (topic)
                   /
master:001 --- master:002 --- master:003 --- master:004  (master)

在这个时候,我们的实验样本已经基本搭建完毕,git-rebase就要派上用场了!
我们假设topic和master是一个项目的两个分支,master当然是主分支,而topic是旁路分支。在软件开发的大部分情况中,旁路分支是要遵从主分支的。所以说,现在topic分支想将master分支开发的最新代码导入到topic分支中,而且要求此动作不影响master主分支的开发,也就是说要暗中完成。git-rebase上场了:
[rocrocket@wupengchong rebase]$ git checkout topic
Switched to branch “topic”
[rocrocket@wupengchong rebase]$ git branch
master
* topic
[rocrocket@wupengchong rebase]$ git rebase master
First, rewinding head to replay your work on top of it…
Applying topic:001
error: patch failed: roc.c:1
error: roc.c: patch does not apply
Using index info to reconstruct a base tree…
Falling back to patching base and 3-way merge…
Auto-merged roc.c
Applying topic:002
[rocrocket@wupengchong rebase]$

我们使用了git rebase master来完成我们的需求。如果你心细的话,你会看到它输出了一些error,意思是说“补丁失败”,这个error没有关系,不影响git-rebase的正常工作的。

让我们来看看git-rebase的魔力吧:

[rocrocket@wupengchong rebase]$ git branch
master
* topic
[rocrocket@wupengchong rebase]$ git log
commit 05de9849078541c86cf5182cd8c15fa22bd00f77
Author: rocrocket <wupengchong@gmail.com>
Date:   Mon Nov 17 15:49:24 2008 +0800

topic:002

commit 7e5a744ef9e0740b4a091e9c8baa859b14800b0b
Author: rocrocket <wupengchong@gmail.com>
Date:   Mon Nov 17 15:48:58 2008 +0800

topic:001

commit b81fbc3be5c7bd1fdef72820c29e2c67590f4b03
Author: rocrocket <wupengchong@gmail.com>
Date:   Mon Nov 17 15:55:23 2008 +0800

master:004

commit 91a7ffc73e6320a86b10849061efd672f47fd5bd
Author: rocrocket <wupengchong@gmail.com>
Date:   Mon Nov 17 15:55:06 2008 +0800

master:003

commit 41b3d1cfaae0184bb8e5f27a165d51cc23867413
Author: rocrocket <wupengchong@gmail.com>
Date:   Mon Nov 17 15:28:01 2008 +0800

master:002

commit 2d89602d0c9955824df0d2c023e447f5d98d863a
Author: rocrocket <wupengchong@gmail.com>
Date:   Mon Nov 17 15:26:40 2008 +0800

master:001

[rocrocket@wupengchong rebase]$ cat roc.c
int main()
{
printf(“topic :002”);
printf(“topic :001”);
printf(“master:001”);
printf(“master:002”);
printf(“master:003”);
printf(“master:004”);
return 0;
}
[rocrocket@wupengchong rebase]$

看到了吧!master分支刚才开发的master:003和master:004也已经悄悄的进入了topic分支的日志里了。而在roc.c文件中也已经有了相应的开发代码。

这下,你是不是有一种豁然开朗的感觉?呵呵 来,看一下分支结构图:

                                              topic:001 --- topic:002  (topic)
                                              /
master:001 --- master:002 --- master:003 --- master:004  (master)

这就是git-rebase的魔力!看出神奇之处了么?
如果忘了,就对比一下。这是执行git-rebase之前的分支结构图:

                  topic:001 --- topic:002  (topic)
                   /
master:001 --- master:002 --- master:003 --- master:004  (master)

git-rebase还有很多其他用法,我们会在以后的章节中继续讲解。:) 今天这个例子非常重要,后续有关git-rebase的例子都会以此例子为基础。

学东西不贪多,贪精:D
over~

12条评论

  1. 提一个小小小小小小的小建议啊,
    可不可以把shell命令和输出用两种不同的颜色来显示呢?
    那样看起来会不会清晰一些?

    1. @wangeguo, 这篇文章里很清楚的说明了两个操作的区别:http://progit.org/book/zh/ch3-6.html

      很抱歉,占用你的博客,如果我一开始就自己查就不会有这个问题了。

  2. After rebase, the “topic:001” should be on top of “master:004” instead of “master:003”. Assumed this is only a typo error in your final figure/diagram. It’s better if you can update it.

  3. 嘿嘿,多谢你的文章,写的又詳細又专业。

    我以前也用rebase来连接过东西,不过不是连接branch和master,而是两个不同的源,比较危险:http://imtx.cn/archives/1197.html

发表您的评论

请您放心,您的信息会被严格保密。必填项已标识 *