Git協作流程詳解

阮一峰的網路日誌發表於2015-12-29

Git

Git 作為一個原始碼管理系統，不可避免涉及到多人協作。

協作必須有一個規範的流程，讓大家有效地合作，使得專案井井有條地發展下去。”協作流程”在英語裡，叫做”workflow”或者”flow”，原意是水流，比喻專案像水流那樣，順暢、自然地向前流動，不會發生衝擊、對撞、甚至漩渦。

本文介紹三種廣泛使用的協作流程：

Git Flow
Github flow
Gitlab flow

如果你對Git還不是很熟悉，可以先閱讀下面的文章。

一、功能驅動

本文的三種協作流程，有一個共同點：都採用“功能驅動式開發”（Feature-driven development，簡稱FDD）。

它指的是，需求是開發的起點，先有需求再有功能分支（feature branch）或者補丁分支（hotfix branch）。完成開發後，該分支就合併到主分支，然後被刪除。

二、Git flow

最早誕生、並得到廣泛採用的一種協作流程，就是Git flow 。

2. 1 特點

它最主要的特點有兩個。

首先，專案存在兩個長期分支。

主分支master
開發分支develop

前者用於存放對外發布的版本，任何時候在這個分支拿到的，都是穩定的分佈版；後者用於日常開發，存放最新的開發版。

其次，專案存在三種短期分支。

功能分支（feature branch）
補丁分支（hotfix branch）
預發分支（release branch）

一旦完成開發，它們就會被合併進develop或master，然後被刪除。

Git flow 的詳細介紹，請閱讀我翻譯的中文版《Git 分支管理策略》。

2. 2 評價

Git flow的優點是清晰可控，缺點是相對複雜，需要同時維護兩個長期分支。大多數工具都將master當作預設分支，可是開發是在develop分支進行的，這導致經常要切換分支，非常煩人。

更大問題在於，這個模式是基於”版本釋出”的，目標是一段時間以後產出一個新版本。但是，很多網站專案是”持續釋出”，程式碼一有變動，就部署一次。這時，master分支和develop分支的差別不大，沒必要維護兩個長期分支。

三、Github flow

Github flow 是Git flow的簡化版，專門配合”持續釋出”。它是 Github.com 使用的協作流程。

3. 1 流程

它只有一個長期分支，就是master，因此用起來非常簡單。

官方推薦的流程如下。

　　第一步：根據需求，從master拉出新分支，不區分功能分支或補丁分支。

第二步：新分支開發完成後，或者需要討論的時候，就向master發起一個pull reqest（簡稱PR）。

第三步：Pull Request既是一個通知，讓別人注意到你的請求，又是一種對話機制，大家一起評審和討論你的程式碼。對話過程中，你還可以不斷提交程式碼。

第四步：你的Pull Request被接受，合併進master，重新部署後，原來你拉出來的那個分支就被刪除。（先部署再合併也可。）

3. 2 評價

Github flow 的最大優點就是簡單，對於”持續釋出”的產品，可以說是最合適的流程。

問題在於它的假設：master分支的更新與產品的釋出是一致的。也就是說，master分支的最新程式碼，預設就是當前的線上程式碼。

可是，有些時候並非如此，程式碼合併進入master分支，並不代表它就能立刻釋出。比如，蘋果商店的APP提交稽核以後，等一段時間才能上架。這時，如果還有新的程式碼提交，master分支就會與剛釋出的版本不一致。另一個例子是，有些公司有釋出視窗，只有指定時間才能釋出，這也會導致線上版本落後於master分支。

上面這種情況，只有master一個主分支就不夠用了。通常，你不得不在master分支以外，另外新建一個production分支跟蹤線上版本。

四、Gitlab flow

Gitlab flow 是 Git flow 與 Github flow 的綜合。它吸取了兩者的優點，既有適應不同開發環境的彈性，又有單一主分支的簡單和便利。它是 Gitlab.com 推薦的做法。

4. 1 上游優先

Gitlab flow 的最大原則叫做”上游優先”（upsteam first），即只存在一個主分支master，它是所有其他分支的”上游”。只有上游分支採納的程式碼變化，才能應用到其他分支。

Chromium專案就是一個例子，它明確規定，上游分支依次為：

Linus Torvalds的分支

子系統（比如netdev）的分支

裝置廠商（比如三星）的分支

4. 2 持續釋出

Gitlab flow 分成兩種情況，適應不同的開發流程。

對於”持續釋出”的專案，它建議在master分支以外，再建立不同的環境分支。比如，”開發環境”的分支是master，”預發環境”的分支是pre-production，”生產環境”的分支是production。

開發分支是預發分支的”上游”，預發分支又是生產分支的”上游”。程式碼的變化，必須由”上游”向”下游”發展。比如，生產環境出現了bug，這時就要新建一個功能分支，先把它合併到master，確認沒有問題，再cherry-pick到pre-production，這一步也沒有問題，才進入production。

只有緊急情況，才允許跳過上游，直接合併到下游分支。

4. 3 版本釋出