如何使用 git rebase 與其他分支合併？

GanniPiece
技術

前言

最近 Plug-In 開發得差不多了，接下來要與夥伴改進與測試目前的合成器，首先遇到的問題就是如何將我們兩個的修改版本進行整合。Git 這個版本控制的工具提供了兩種容易上手的方法，分別是 merge 與 rebase 。

在這篇文章中，我會先說明 rebase 的使用方法，並以我們在開發中的使用情境提供一個簡單的範例。

方法

Rebase 的意思即是以某個 branch 作為基準來做整合，假設今天有兩條 branches A 和 B，並且在這兩條 branches 中存在版本差異，那我們就必須對差異的部分進行整合。

  1. 如果我們希望以 A 分支作為基準，我們首先需要將 branch 切到 A 分支上
	❯ git checkout A
  1. 確認 HEAD 所在的分支
1	❯ git status
2	On branch A
3	nothing to commit, working tree clean
  1. B rebase A
1	❯ # (on branch B)
2	❯ git rebase A
  1. 若兩個版本間有衝突，依照 git 輸出的訊息逐一對衝突處進行修改
  2. 修改完後將檔案加入 stage
1	❯ git add <modified file name>
  1. 重複步驟 4, 5，並繼續 rebase 直至所有衝突解決
1	❯ git rebase --continue

範例

今天要新增兩個獨立的功能，於是我和夥伴一人各開一條 branch 進行開發，分別在 branch A 和 branch B。此 時夥伴已將功能 A 開發完成，而我想要先在B branch 上顯示夥伴完成的介面功能，就可以用 rebase 的方式將他 的功能加入我當前的分支。

以簡單的例子來看，原先在 develop 上面有 d.cpp 這個檔案。在開發的過程中，我們分別對 A, B 加入 a.cpp, b.cpp 兩個檔案。

  1. 最初的 d.cpp (branch ‘develop’)
1#include <iostream>
2int main()
3{
4	std::cout << "D" << std::endl;
5}
  1. 在 branch A 修改 d.cpp
1#include <iostream>
2int main()
3{
4	std::cout << "A" << std::endl;
5}
  1. 在 branch B 修改 d.cpp
1#include <iostream>
2int main()
3{
4	std::cout << "B" << std::endl;
5}

此時，如果我們要將以 A 為基準來 rebase B，就會遇到檔案衝突的問題。

1Auto-merging d.cpp
2CONFLICT (content): Merge conflict in d.cpp
3error: could not apply 1b2cb82... Update B
4Resolve all conflicts manually, mark them as resolved with
5"git add/rm <conflicted_files>", then run "git rebase --continue".
6You can instead skip this commit: run "git rebase --skip".
7To abort and get back to the state before "git rebase", run "git rebase --abort".
8Could not apply 1b2cb82... Update B

由訊息得知我們在 d.cpp 這個檔案中有衝突，必須先將其解決，再使用 git rebase --continue 指令完成這 次的 rebase。

  1. 開啟 d.cpp，解決其中衝突
 1#include <iostream>
 2
 3int main()
 4{
 5<<<<<<< HEAD
 6    std::cout << "A" << std::endl;
 7=======
 8    std::cout << "B" << std::endl;
 9>>>>>>> 1b2cb82 (Update B)
10
11}
  1. 選擇要留下的版本後，加入 stage
  2. git rebase --continue 後，重複步驟5 直至所有衝突解決
  3. 完成