ps:本文轉(zhuǎn)載于 ： https://www.ibm.com/developerworks/cn/java/j-lo-git-mange/index.html

Git 是目前最流行的源代碼管理工具。大量的軟件項目由 GitHub、Bitbucket 和 GitLab 這樣的云服務(wù)平臺或是私有的 Git 倉庫來管理。在使用 Git 時通常會遇到的一個問題是采用何種分支管理實踐，即如何管理倉庫中作用不同的各類分支。和軟件開發(fā)中的其他實踐一樣，Git 分支管理并沒有普遍適用的最佳做法，而只有對每個團隊和項目而言最適合的做法。簡單來說，在項目開發(fā)中使用多個分支會帶來額外的管理和維護開銷，但是多個分支對于項目的團隊合作、新功能開發(fā)和發(fā)布管理都是有一定好處的。不同的團隊可以根據(jù)團隊人員組成和意愿、項目的發(fā)布周期等因素選擇最適合的策略，找到最適合團隊的管理方式。本文將介紹三種常見的 Git 分支管理方式。

單主干

單主干的分支實踐（Trunk-based development，TBD）在 SVN 中比較流行。Google 和 Facebook 都使用這種方式。trunk 是 SVN 中主干分支的名稱，對應(yīng)到 Git 中則是 master 分支。TBD 的特點是所有團隊成員都在單個主干分支上進行開發(fā)。當需要發(fā)布時，先考慮使用標簽（tag），即 tag 某個 commit 來作為發(fā)布的版本。如果僅靠 tag 不能滿足要求，則從主干分支創(chuàng)建發(fā)布分支。bug 修復(fù)在主干分支中進行，再 cherry-pick 到發(fā)布分支。圖 1 是 TBD 中分支流程的示意圖。

圖 1. TBD 中的分支流程的示意圖

由于所有開發(fā)人員都在同一個分支上工作，團隊需要合理的分工和充分的溝通來保證不同開發(fā)人員的代碼盡可能少的發(fā)生沖突。持續(xù)集成和自動化測試是必要的，用來及時發(fā)現(xiàn)主干分支中的 bug。因為主干分支是所有開發(fā)人員公用的，一個開發(fā)人員引入的 bug 可能對其他很多人造成影響。不過好處是由于分支所帶來的額外開銷非常小。開發(fā)人員不需要頻繁在不同的分支之間切換。

GitHub flow

GitHub flow 是 GitHub 所使用的一種簡單的流程。該流程只使用兩類分支，并依托于 GitHub 的 pull request 功能。在 GitHub flow 中，master 分支中包含穩(wěn)定的代碼。該分支已經(jīng)或即將被部署到生產(chǎn)環(huán)境。master 分支的作用是提供一個穩(wěn)定可靠的代碼基礎(chǔ)。任何開發(fā)人員都不允許把未測試或未審查的代碼直接提交到 master 分支。

對代碼的任何修改，包括 bug 修復(fù)、hotfix、新功能開發(fā)等都在單獨的分支中進行。不管是一行代碼的小改動，還是需要幾個星期開發(fā)的新功能，都采用同樣的方式來管理。當需要進行修改時，從 master 分支創(chuàng)建一個新的分支。新分支的名稱應(yīng)該簡單清晰地描述該分支的作用。所有相關(guān)的代碼修改都在新分支中進行。開發(fā)人員可以自由地提交代碼和 push 到遠程倉庫。

當新分支中的代碼全部完成之后，通過 GitHub 提交一個新的 pull request。團隊中的其他人員會對代碼進行審查，提出相關(guān)的修改意見。由持續(xù)集成服務(wù)器（如 Jenkins）對新分支進行自動化測試。當代碼通過自動化測試和代碼審查之后，該分支的代碼被合并到 master 分支。再從 master 分支部署到生產(chǎn)環(huán)境。圖 2 是 GitHub flow 分支流程的示意圖。

圖 2. Github flow 中的分支流程的示意圖

GitHub flow 的好處在于非常簡單實用。開發(fā)人員需要注意的事項非常少，很容易形成習慣。當需要進行任何修改時，總是從 master 分支創(chuàng)建新分支。完成之后通過 pull request 和相關(guān)的代碼審查來合并回 master 分支。GitHub flow 要求項目有完善的自動化測試、持續(xù)集成和部署等相關(guān)的基礎(chǔ)設(shè)施。每個新分支都需要測試和部署，如果這些不能自動化進行，會增加開發(fā)人員的工作量，導(dǎo)致無法有效地實施該流程。這種分支實踐也要求團隊有代碼審查的相應(yīng)流程。

git-flow

git-flow 應(yīng)該是目前流傳最廣的 Git 分支管理實踐。git-flow 圍繞的核心概念是版本發(fā)布（release）。因此 git-flow 適用于有較長版本發(fā)布周期的項目。雖然目前推崇的做法是持續(xù)集成和隨時發(fā)布。有的項目甚至可以一天發(fā)布很多次。隨時發(fā)布對于 SaaS 服務(wù)類的項目來說是很適合的。不過仍然有很大數(shù)量的項目的發(fā)布周期是幾個星期甚至幾個月。較長的發(fā)布周期可能是由于非技術(shù)相關(guān)的因素造成的，比如人員限制、管理層決策和市場營銷策略等。

git-flow 流程中包含 5 類分支，分別是 master、develop、新功能分支（feature）、發(fā)布分支（release）和 hotfix。這些分支的作用和生命周期各不相同。master 分支中包含的是可以部署到生產(chǎn)環(huán)境中的代碼，這一點和 GitHub flow 是相同的。develop 分支中包含的是下個版本需要發(fā)布的內(nèi)容。從某種意義上來說，develop 是一個進行代碼集成的分支。當 develop 分支集成了足夠的新功能和 bug 修復(fù)代碼之后，通過一個發(fā)布流程來完成新版本的發(fā)布。發(fā)布完成之后，develop 分支的代碼會被合并到 master 分支中。

其余三類分支的描述如表 1所示。這三類分支只在需要時從 develop 或 master 分支創(chuàng)建。在完成之后合并到 develop 或 master 分支。合并完成之后該分支被刪除。這幾類分支的名稱應(yīng)該遵循一定的命名規(guī)范，以方便開發(fā)人員識別。

表 1. git-flow 分支類型

分支類型命名規(guī)范創(chuàng)建自合并到說明

feature	feature/*	develop	develop	新功能
release	release/*	develop	develop 和 master	一次新版本的發(fā)布
hotfix	hotfix/*	master	develop 和 master	生產(chǎn)環(huán)境中發(fā)現(xiàn)的緊急 bug 的修復(fù)

對于開發(fā)過程中的不同任務(wù)，需要在對應(yīng)的分支上進行工作并正確地進行合并。每個任務(wù)開始前需要按照指定的步驟完成分支的創(chuàng)建。例如當需要開發(fā)一個新的功能時，基本的流程如下：

• 從 develop 分支創(chuàng)建一個新的 feature 分支，如 feature/my-awesome-feature。
• 在該 feature 分支上進行開發(fā)，提交代碼，push 到遠端倉庫。
• 當代碼完成之后，合并到 develop 分支并刪除當前 feature 分支。

在進行版本發(fā)布和 hotfix 時也有類似的流程。當需要發(fā)布新版本時，采用的是如下的流程：

• 從 develop 分支創(chuàng)建一個新的 release 分支，如 release/1.4。
• 把 release 分支部署到持續(xù)集成服務(wù)器上進行測試。測試包括自動化集成測試和手動的用戶接受測試。
• 對于測試中發(fā)現(xiàn)的問題，直接在 release 分支上提交修改。完成修改之后再次部署和測試。
• 當 release 分支中的代碼通過測試之后，把 release 分支合并到 develop 和 master 分支，并在 master 分支上添加相應(yīng)的 tag。

因為 git-flow 相關(guān)的流程比較繁瑣和難以記憶，在實踐中一般使用輔助腳本來完成相關(guān)的工作。比如同樣的開發(fā)新功能的任務(wù)，可以使用 git flow feature start my-awesome-feature 來完成新分支的創(chuàng)建，使用 git flow feature finish my-awesome-feature 來結(jié)束 feature 分支。輔助腳本會完成正確的分支創(chuàng)建、切換和合并等工作。

Maven JGit-Flow

對于使用 Apache Maven 的項目來說，Atlassian 的 JGit-Flow 是一個更好的 git-flow 實現(xiàn)。JGit-Flow 是一個基于 JGit 的純 Java 實現(xiàn)的 git-flow，并不需要安裝額外的腳本，只需要作為 Maven 的插件添加到 Maven 項目中即可。JGit-Flow 同時可以替代 Maven release 插件來進行發(fā)布管理。JGit-Flow 會負責正確的設(shè)置不同分支中的 Maven 項目的 POM 文件中的版本，這對于 Maven 項目的構(gòu)建和發(fā)布是很重要的。

在 Maven 項目的 pom.xml 文件中添加代碼清單1中的插件聲明就可以使用 JGit-Flow。<configuration>中包含的是 JGit-Flow 不同任務(wù)的配置。

清單 1. JGit-Flow 的 Maven 設(shè)置

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18

<build> ???<plugins> ???????<plugin> ???????????<groupId>external.atlassian.jgitflow</groupId> ???????????<artifactId>jgitflow-maven-plugin</artifactId> ???????????<version>1.0-m5.1</version> ???????????<configuration> ??????????????<flowInitContext> ????????????????<versionTagPrefix>release-</versionTagPrefix> ??????????????</flowInitContext> ???????????????<releaseBranchVersionSuffix>RC</releaseBranchVersionSuffix> ???????????????<noDeploy>true</noDeploy> ???????????????<allowSnapshots>true</allowSnapshots> ???????????????<allowUntracked>true</allowUntracked> ???????????</configuration> ???????</plugin> ???</plugins> </build>

JGit-Flow 提供了很多配置選項，可以在 POM 文件中聲明。這些配置項可以對不同的任務(wù)生效。常用的配置項如表2 所示。

表 2. JGit-Flow 的配置項

名稱描述適用任務(wù)

flowInitContext	配置不同類型的分支的名稱	全局
allowSnapshots	是否允許存在 SNAPSHOT 類型的依賴	?
allowUntracked	是否允許本地 Git 中存在未提交的內(nèi)容	?
scmCommentPrefix 和 scmCommentSuffix	JGit-Flow 會進行代碼合并工作。通過這兩個配置項來設(shè)置 JGit-Flow 進行代碼提交時的消息的前綴和后綴	全局
username 和 password	進行 Git 認證時的用戶名和密碼，適用于 HTTPS 倉庫	全局
releaseBranchVersionSuffix	release 分支中項目的 POM 文件版本號的后綴	?
developmentVersion	下一個開發(fā)版本的版本號	?
releaseVersion	發(fā)布版本的版本號	?
pushReleases	是否把 release 分支 push 到遠程倉庫	?
goals	當部署發(fā)布版本到 Maven 倉庫時執(zhí)行的目標	release-finish，hotfix-finish
keepBranch	當發(fā)布完成之后是否保留相應(yīng)的分支	release-finish，hotfix-finish
noDeploy	是否啟用部署到 Maven 倉庫的功能	release-finish，hotfix-finish
noReleaseBuild	在完成發(fā)布時是否禁用 Maven 構(gòu)建	release-finish
noReleaseMerge	在完成發(fā)布時是否把 release 分支合并回 develop 和 master 分支	release-finish
noTag	在完成發(fā)布時是否添加標簽	release-finish，hotfix-finish
squash	在進行分支合并時，是否把多個 commit 合并成一個	release-finish，hotfix-finish
featureName	新特性分支的名稱	feature-start，feature-finish，feature-deploy
pushFeatures	是否把特性分支 push 到遠程倉庫	feature-start，feature-finish
noFeatureBuild	在完成特性時是否禁用 Maven 構(gòu)建	feature-finish
noFeatureMerge	在完成特性時是否把特性分支合并回 develop	feature-finish
pushHotfixes	在完成 hotfix 時是否把分支合并回 master	hotfix-finish
noHotfixBuild	在完成 hotfix 時是否禁用 Maven 構(gòu)建	hotfix-finish

其余的配置項可以參考插件不同任務(wù)的文檔。

在啟用了 JGit-Flow 之后，可以通過 mvn 運行 jgitflow:feature-start 和 jgitflow:feature-finish 來開始和結(jié)束新特性的開發(fā)。與版本發(fā)布和 hotfix 相關(guān)的命令分別是 jgitflow:release-start 和 jgitflow:release-finish 以及 jgitflow:hotfix-start 和 jgitflow:hotfix-finish。在運行命令之后，JGit-Flow 會完成相關(guān)的 Git 分支創(chuàng)建、合并、刪除、添加 tag 等操作，不需要開發(fā)人員手動完成。

每個分支的 pom.xml 中的版本號的格式并不相同。如 master 分支的版本號是標準的發(fā)布版本號，如 1.2.3；develop 分支中則是 SNAPSHOT 版本，比 master 分支的版本號要高，如 1.2.4-SNAPSHOT；release 分支可以通過<releaseBranchVersionSuffix>配置來指定版本號的后綴，如 1.2.3-RC-SNAPSHOT；feature 分支可以通過<enableFeatureVersions>配置來把 feature 分支名稱作為后綴添加到版本號中，如 1.2.3-my-awesome-feature-SNAPSHOT；hotfix 分支的版本號基于 master 分支的版本號，如 1.2.3.1 是對于 1.2.3 版本的第一個 hotfix。當使用 jgitflow:release-finish 完成一個 release 分支時，develop 分支的版本號會被自動更新成下一個小版本，如從 1.2.3 到 1.2.4。當需要手動修改版本號時，可以使用 Versions 插件，如 mvn versions:set -DnewVersion=2.0.0-SNAPSHOT。

持續(xù)集成

由于 JGit-Flow 是純 Java 的 Maven 插件實現(xiàn)，可以很容易的與常用的持續(xù)集成服務(wù)器進行集成。不過在與 Atlassian 的 Bamboo 集成時，有幾個細節(jié)需要注意。首先是 Bamboo 在進行構(gòu)建的時候，使用的是一個虛擬的 Git 倉庫，其倉庫地址是一個不存在的文件系統(tǒng)路徑。因此需要在 JGit-Flow 的配置中手動設(shè)置 Git 倉庫的地址，保證 Git 操作可以正確執(zhí)行，如代碼清單2所示。

清單 2. 手動設(shè)置 JGit-Flow 的 Git 倉庫地址

1 2 3 4

<configuration> ???<defaultOriginUrl>[Git url]</defaultOriginUrl> ???<alwaysUpdateOrigin>true</alwaysUpdateOrigin> </configuration>

另外在開始新的 release 之前，需要確保前一個發(fā)布分支已經(jīng)被刪除。JGit-Flow 在默認情況下會自動在發(fā)布完成之后，刪除對應(yīng)的 Git 分支。但是可能本地倉庫中還保留有之前的發(fā)布分支，這會導(dǎo)致新的 release-start 任務(wù)執(zhí)行失敗。一種解決方式是每次都重新 checkout 新的倉庫，這樣可以保證不會出現(xiàn)已經(jīng)在遠程被刪除的分支。不過可能會增加構(gòu)建的時間。另外一種解決方式是通過 Git 命令來刪除本地分支，如代碼清單3所示。

清單 3. 刪除 Git 本地分支

1 2 3 4 5 6 7 8

${bamboo.capability.system.git.executable} fetch --prune --verbose ${bamboo.capability.system.git.executable} branch -vv | awk '/: gone]/{print $1}' | ??????????????????????xargs ${bamboo.capability.system.git.executable} branch -d 2> /dev/null echo 'stale branches deleted' Git 分支合并沖突處理

當把發(fā)布分支合并到 develop 時，可能會出現(xiàn)沖突。因為在發(fā)布分支中有與 bug fix 相關(guān)的改動，在 develop 分支中有可能修改相同的文件。當有沖突時，直接運行 JGit-Flow 的 release-finish 任務(wù)會出錯。這個時候需要開發(fā)人員手動把發(fā)布分支合并到 develop 分支，并解決相應(yīng)的沖突。然后再次運行 release-finish 任務(wù)即可。

選擇合適的實踐

每個開發(fā)團隊都應(yīng)該根據(jù)團隊自身和項目的特點來選擇最適合的分支實踐。首先是項目的版本發(fā)布周期。如果發(fā)布周期較長，則 git-flow 是最好的選擇。git-flow 可以很好地解決新功能開發(fā)、版本發(fā)布、生產(chǎn)系統(tǒng)維護等問題；如果發(fā)布周期較短，則 TBD 和 GitHub flow 都是不錯的選擇。GitHub flow 的特色在于集成了 pull request 和代碼審查。如果項目已經(jīng)使用 GitHub，則 GitHub flow 是最佳的選擇。GitHub flow 和 TBD 對持續(xù)集成和自動化測試等基礎(chǔ)設(shè)施有比較高的要求。如果相關(guān)的基礎(chǔ)設(shè)施不完善，則不建議使用。

小結(jié)

Git 作為目前最流行的源代碼管理工具，已經(jīng)被很多開發(fā)人員所熟悉和使用。在基于 Git 的團隊開發(fā)中，Git 分支的作用非常重要，可以讓團隊的不同成員同時在多個相對獨立的特性上工作。本文對目前流行的 3 種 Git 分支管理實踐做了介紹，并著重介紹了 git-flow 以及與之相關(guān)的 Maven JGit-Flow 插件。

相關(guān)主題

• 了解 Google 和 Facebook 的單主干實踐。
• 了解 GitHub flow 的更多內(nèi)容。
• 了解 git-flow 的更多內(nèi)容。
• 了解 Maven JGit-Flow 插件的更多內(nèi)容。
• developerWorks Java 技術(shù)專區(qū)：這里有數(shù)百篇關(guān)于 Java 編程各個方面的文章。

總結(jié)

以上是生活随笔為你收集整理的git学习------gt;Git 分支管理最佳实践的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯，歡迎將生活随笔推薦給好友。