0. Origin
A successful Git branching model 一切起源于這篇文章, 后來的各種 git flow 基本都符合這篇文章的思想.
文章給大家帶來這張圖
origin_gitflow.png
本文以 A successful Git branching model 為基礎, 探討保持分支線性的問題.
實踐
在我的實踐過程中, 確定了以下關鍵原則.
- Git 倉庫是分布式, 無中心的.
- 但是希望我們的分支模型里, 同一個分支是有中心保持線性的.
- develop 分支的提交粒度是該特性.
擁有了利器, 我們開始工作了:
git init
git checkout -b develop
git checkout -b feature1
git commit -m '(╯‵□′)╯︵┻━┻'
git commit -m "┬─┬ ノ( ' - 'ノ)"
git checkout develop
git merge feature1 --no-ff
此時我們的分支大概長成這樣
* 89c7380 - (HEAD, develop) Merge branch 'contents' into develop (36 seconds ago)
|\
| * 5637569 - (contents) add git command (55 seconds ago)
| * 642e6dc - add title (2 minutes ago)
|/
* 43bf08a - (master) scanner online (3 minutes ago)
再復雜一點
#初始化
git init
git commit
git checkout -b develop
# 開始開發 content
git checkout -b content
git commit
# 此時我們需要去開發另外一個特性 extral
git checkout develop
git checkout -b extral
git commit
# extral 開發完成
git checkout develop
git merge --no-ff extral
# 回來繼續開發 content
git checkout content
git commit
# 完成
git checkout develop
git merge --no-ff content
此時我們的分支長成這樣
* 316e0ca - (HEAD, develop) Merge branch 'another' into develop (25 seconds ago)
|\
| * d6595ab - add extral command (50 seconds ago)
| * e0f3b56 - another branch (3 minutes ago)
* | 3ae3288 - Merge branch 'extral' into develop (2 minutes ago)
|\ \
| |/
|/|
| * 4203945 - add extral file (2 minutes ago)
|/
* 89c7380 - Merge branch 'contents' into develop (7 minutes ago)
|\
| * 5637569 - add git command (7 minutes ago)
| * 642e6dc - add title (9 minutes ago)
|/
* 43bf08a - (master) scanner online (10 minutes ago)
完美符合理想的分支模型. 并且保留了并行開發的記錄.
這個時候我們加入了另外一個小伙伴. 分別在各自的按照這個流程工作.
這時候就有可能出現 *1 ahead* 2 *behind* 類似的情況, 此時意味著本地的 develop 分支與遠程的 develop 分支產生了分叉. 必須先 pull. 但是如果直接 pull 則會產生這樣的結果.
Merge branch 'develop' of <REMOTE> into develop
此時我們的 develop 分支不再是一條直線. 而且產生了一個無意義的合并節點. 破壞了 develop 分支以特性為粒度按照代碼提交時間排序的目標原則.
這時候需要rebase. 但是直接執行 git pull --rebase 會刪除剛才特性分支合并入 develop 分支的節點. 像這樣
A
| \
B H
| |
C G
| |
D F
| /
E
git pull --rebase 后
H
|
G
|
F
|
X <- 遠程的新節點
|
B
|
C
|
D
|
E
想要保留節點就要加入 preserve 參數.
git fetch origin
git rebase origin/develop --preserve-merges
或者
git config pull.rebase preserve
git pull
總結
- 分支模型的確立是從工程實踐出發的. 我們需要多人協同合作, 如果合并進入 develop 分支的都由 pull request 進行. 這時的 develop 分支完全就是中心, 自然是完全線性的. 但是實際情況往往更復雜一些, 我們沒有選擇完全死板的遵守 pull request 流程. 同時我們又希望保證 develop 分支的線性, 就引入了上面問題, 并解決了它.
- 這里其實就是
merge和rebase的使用選擇問題, 推廣開就是我們在同一個分支的合并上使用rebase, 在不同分支的合并上使用merge同時使用 --no-ff 保留分支歷史, 保證提交粒度. (當然 master 和 develop 分支外的其它地方自由選擇即可). - 如果特性分支只有一個 commit 節點, 那么其粒度與合并節點相等, 可以選擇不使用 --no-ff (新版的 git flow 中是這么做的)
參考資料:
