Git rebase

Name

git-rebase - Reapply commits on top of another base tip

SYNOPSIS

git rebase [-i | --interactive] [<options>] [--exec <cmd>]
	[--onto <newbase> | --keep-base] [<upstream> [<branch>]]
git rebase [-i | --interactive] [<options>] [--exec <cmd>] [--onto <newbase>]
	--root [<branch>]
git rebase (--continue|--skip|--abort|--quit|--edit-todo|--show-current-patch)

reabse 翻成中文大概是「重新定義分支的參考基準」。

假設我們現在在topic branch上:

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

輸入下列指令後:

git rebase master
git rebase master topic

歷史紀錄會變成這樣:

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

看起來像是把 A、B、C 從 E 上面，剪下貼上到 G 上面，
不過實際上是這樣:

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

A'、B'、C'是新創建的 commit，SHA-1與舊的 A、B、C commit都會不一樣。
而舊的 A、B、C commit 仍然存在，並未被刪除，
不過因為已經沒有 branch 指向它，所以沒有顯示出來，
就在那邊等待 Git 的資源回收機制處理他們。

不過因為rebase等於是修改歷史，
所以不應該將已經push出去的內容任意進行rebase，
不然可能會造成團隊協作的困擾。

我個人比較常用的應用是修改還未push上去的 commit message，
有時候可能已經 commit 很多了，
但發現中間的 commit message 需要修改:

 • "commit 5" (HEAD)
 ◦ "commit 4"
 ◦ "commi 3"
 ◦ "commit 2"
 ◦ "commit 1"

這時候只要使用rebase:

git reabse -i HEAD~3

-i是--interactive的縮寫，指將 commit 列出，讓使用者可以在rebase前進行修改。

-i
--interactive
Make a list of the commits which are about to be rebased. Let the user edit that list before rebasing.

會出現:

pick xxxxxxxx commit 5
pick xxxxxxxx commit 4
pick xxxxxxxx commi 3

# Rebase xxxxxxxx..xxxxxxxx onto xxxxxxxx (3 commands)
#
# p, pick <commit> = use commit
# r, reword <commit> = use commit, but edit the commit message
# e, edit <commit> = use commit, but stop for amending
# s, squash <commit> = use commit, but meld into previous commit
# f, fixup <commit> = like "squash", but discard this commit's log message
# x, exec <command> = run command (the rest of the line) using shell

這時候我們按照提示，使用 vim 指令i(指INSERTr)，將 "pick" 改成 "r"或"reword":

pick xxxxxxxx commit 5
pick xxxxxxxx commit 4
reword xxxxxxxx commi 3

再使用vim指令ESC :wq Enter，就可以修改 commit message 了。

參考資料

https://git-scm.com/docs/git-rebase
https://medium.com/程式乾貨/git-rebase-使用場景-604d753e53f6
https://gitbook.tw/chapters/branch/merge-with-rebase