版本控制系統在現代軟體開發中扮演著至關重要的角色，有效管理程式碼版本迭代與團隊協作。本文將深入探討集中式與分散式版本控制系統的差異，並著重於 Git 的應用，說明如何在 API 專案中有效運用 Git 進行版本控管，包含本地倉函式庫的建立、程式碼提交、分支管理、.gitignore 設定等。同時，文章也涵蓋了 GitHub 與 GitLab 兩大平臺的比較與應用，最後示範如何結合 Maven 與 Nexus 倉函式庫，建構 Java API 的發布流程，提供開發者一套完整的版本控管策略，確保程式碼的穩定性與可追溯性。
版本控制系統：集中式與分散式
在軟體開發中，版本控制系統是一種必不可少的工具，讓多個開發者可以合作完成專案。版本控制系統可以分為集中式和分散式兩種。
集中式版本控制系統
集中式版本控制系統是指所有開發者都連線到一個中央伺服器，該伺服器儲存著專案的所有版本。在這種系統中，開發者需要先從中央伺服器下載最新版本的程式碼，然後在本地修改，最後再將修改好的程式碼提交回中央伺服器。
分散式版本控制系統
分散式版本控制系統則是每個開發者都有一個完整的專案副本，開發者可以在本地進行修改，然後再提交到中央伺服器。這種系統的優點是，即使沒有連線到網路，開發者仍然可以進行版本控制。
Git是一種分散式版本控制系統，廣泛用於軟體開發中。Git提供了一套命令列介面，讓開發者可以建立本地倉函式庫、建立程式碼分支、提交程式碼修改等。
Git的安裝和使用
要使用Git，首先需要下載並安裝Git。安裝完成後，需要確保Git的安裝路徑已經新增到系統的PATH環境變數中。
Git的命令列介面
Git的命令列介面提供了一系列命令，讓開發者可以管理專案的版本。例如，git init命令可以建立一個新的本地倉函式庫，git add命令可以將檔案新增到倉函式庫中，git commit命令可以提交程式碼修改等。
GitHub和GitLab
GitHub和GitLab是兩種根據Git的集中式版本控制平臺。這兩種平臺提供了一個中央倉函式庫，讓開發者可以將自己的專案倉函式庫儲存在上面，並且可以與其他開發者合作完成專案。
GitHub和GitLab的區別
GitHub和GitLab都是根據Git的集中式版本控制平臺，但是它們有不同的功能和特點。GitHub是最早的根據Git的集中式版本控制平臺，而GitLab則是一種更為靈活和可定製的平臺。
Git在API專案中的應用
在API專案中，Git可以用於管理專案的版本。以下是使用Git管理API專案的步驟：
步驟1：建立本地倉函式庫
首先，需要建立一個新的本地倉函式庫。可以使用git init命令建立一個新的本地倉函式庫。
內容解密：
# 建立一個新的本地倉函式庫
git init
這個命令會建立一個新的本地倉函式庫，在專案目錄中建立一個名為.git的目錄，用於儲存專案的版本資訊。
步驟2：新增檔案到倉函式庫中
然後，需要將檔案新增到倉函式庫中。可以使用git add命令將檔案新增到倉函式庫中。
內容解密：
# 新增檔案到倉函式庫中
git add.
這個命令會將所有檔案新增到倉函式庫中。
步驟3：提交程式碼修改
最後，需要提交程式碼修改。可以使用git commit命令提交程式碼修改。
內容解密：
# 提交程式碼修改
git commit -m "Initial commit"
這個命令會提交程式碼修改，並新增一個提交訊息。
圖表翻譯：
graph LR
A[建立本地倉函式庫] --> B[新增檔案到倉函式庫中]
B --> C[提交程式碼修改]
這個圖表顯示了使用Git管理API專案的步驟。首先，需要建立一個新的本地倉函式庫。然後，需要將檔案新增到倉函式庫中。最後，需要提交程式碼修改。
Git版本控制系統的設定與使用
當您嘗試在Windows命令提示符中使用Git時，可能會遇到一個錯誤，指出系統找不到Git。這通常是因為Git的安裝路徑沒有被新增到系統的環境變數中。要解決這個問題，您需要前往系統環境變數設定，找到PATH變數，並將Git安裝路徑新增到其中。完成後，記得重新啟動命令提示符，以便更改生效。
建立本地倉函式庫
一旦Git設定完成，您就可以開始建立本地倉函式庫了。在您的專案目錄中，執行適當的Git命令以初始化一個新的Git儲存函式庫。成功建立後，您會在專案目錄中看到一個名為.git的隱藏目錄。注意，這個目錄預設是隱藏的，因此您可能需要在資料夾選項中選擇顯示隱藏檔案和目錄才能看到它。
顯示隱藏檔案和目錄
為了能夠看到.git目錄，您需要確保Windows檔案資源管理器的設定允許顯示隱藏檔案和目錄。這可以透過檔案夠選項中的「檢視」標籤進行設定。
在GitLab上建立中央倉函式庫
接下來，您需要在GitLab上建立一個中央倉函式庫。首先，登入您的GitLab帳戶，如果您還沒有帳戶，可以進行註冊。登入後，您會進入Dashboard頁面，在這裡您可以點選「New Project」按鈕來建立一個新的專案。
建立新專案
在建立新專案的頁面上，您可以選擇建立一個空白的倉函式庫。輸入您的專案名稱，設定專案的可見性級別（例如，私有），然後點選「Create Project」按鈕。這樣就會建立出一個空白的Git儲存函式庫。
提交程式碼到本地倉函式庫
現在，您需要將程式碼提交到本地倉函式庫。首先，開啟命令提示符，導航到您的專案目錄。然後，您可以建立一個新的分支，並將程式碼提交到這個分支。建立分支的命令是git checkout -b <BranchName>，這樣您就可以在不影響主分支的情況下進行程式碼修改和提交。
建立並切換到新分支
假設您想建立一個名為FirstBranch的分支，您可以使用以下命令：
git checkout -b FirstBranch
接下來，您可能需要在專案目錄中建立一個.gitignore檔案，以指定哪些檔案或目錄不應該被Git追蹤。這個檔案的內容取決於您的具體需求，例如，您可能想要忽略某些編譯產生的檔案或臨時檔案。
####.gitignore檔案範例
以下是一個簡單的.gitignore檔案範例：
# 忽略編譯產生的檔案
/target/
# 忽略IDE的臨時檔案
/.idea/
這樣，您就完成了建立本地倉函式庫、在GitLab上建立中央倉函式庫，以及提交程式碼到本地倉函式庫的基本流程。
圖表翻譯：
graph LR
A[初始化Git儲存函式庫] --> B[建立中央倉函式庫]
B --> C[提交程式碼到本地倉函式庫]
C --> D[推播程式碼到中央倉函式庫]
這個流程圖簡單地展示了從初始化Git儲存函式庫開始，到建立中央倉函式庫，然後提交程式碼到本地倉函式庫，最後推播程式碼到中央倉函式庫的過程。每一步驟都對應著上述的具體操作。
整合Maven與Nexus倉函式庫並建立自由式工作以發布Java API
在本章中，我們將探討如何整合Maven與Nexus倉函式庫，並建立自由式工作以發布Java API。首先，我們需要設定.gitignore檔案，以確保不追蹤某些目錄和檔案的變化。
設定.gitignore檔案
.gitignore檔案包含了不想要追蹤的目錄和檔名稱。例如，我們可以新增以下內容到.gitignore檔案中：
.settings
Target
.classpath
.project
這樣，Git就不會追蹤這些目錄和檔案的變化。
Git版本控制系統
Git版本控制系統有三個主要區域：
- 工作目錄（Working directory）：尚未被Git追蹤的程式碼，Git系統尚未感知其變化。
- 暫存區（Staging area）：如果您想要Git系統追蹤程式碼變化，則需要將程式碼新增到暫存區。
- 提交區（Commit area）：一旦您將變化提交到此區域，則變化就成為程式碼分支的一部分。
將API程式碼新增到暫存區
在提交程式碼之前，我們需要將API程式碼新增到暫存區。可以使用git add命令來實作此操作。該命令會將所有目錄和檔案（除了新增到.gitignore檔案中的）新增到暫存區。
設定使用者名稱和電子郵件
為了設定使用者名稱和電子郵件，請使用以下命令：
git config --global user.name <使用者名稱>
git config --global user.email <電子郵件>
例如，我們可以設定使用者名稱為Pranodayd，電子郵件為pranodayd@example.com。
提交變化
現在，我們可以提交變化到分支中。使用以下命令：
git commit -m "<提交訊息>"
例如，我們可以提交變化並新增提交訊息First commit in Java API project。
推播程式碼到中央倉函式庫
為了推播程式碼到中央倉函式庫，請使用以下命令：
git push -u <GitLab倉函式庫URL> <分支名稱>
您可以從GitLab獲得倉函式庫URL。然後，使用該URL和分支名稱來推播程式碼。
建立主分支
現在，我們需要建立一個新的主分支（Master），用於合併個別開發者的變化。為了建立主分支，請按照以下步驟操作：
- 點選「新分支」選項。
- 輸入分支名稱
Master。 - 點選「建立分支」按鈕。
這樣，您就建立了兩個分支：FirstBranch和Master。現在，您需要將預設分支從FirstBranch改為Master。
圖表翻譯：
graph LR
A[工作目錄] --> B[暫存區]
B --> C[提交區]
C --> D[中央倉函式庫]
D --> E[主分支]
內容解密：
以上步驟描述瞭如何整合Maven與Nexus倉函式庫，並建立自由式工作以發布Java API。首先，我們設定了.gitignore檔案，以確保不追蹤某些目錄和檔案的變化。然後，我們將API程式碼新增到暫存區，並提交變化到分支中。接下來，我們推播程式碼到中央倉函式庫，並建立了一個新的主分支（Master），用於合併個別開發者的變化。最後，我們將預設分支從FirstBranch改為Master。
從技術架構視角來看，版本控制系統選型的核心在於理解集中式與分散式架構的差異。本文深入淺出地介紹了Git作為分散式版本控制系統的優勢，尤其在離線工作和分支管理方面的靈活性。分析Git的命令列操作、GitHub/GitLab平臺的運用以及在API專案中的實踐流程，可以發現Git的學習曲線雖略陡峭，但其提供的版本控制粒度和協作效率極高，有效降低了團隊開發的溝通成本和整合風險。然而，分散式架構也意味著每個開發者擁有完整的程式碼函式庫，在大型專案中可能造成儲存空間的壓力。展望未來，隨著雲端技術的普及和儲存成本的降低，預計根據Git的協作開發模式將持續成為主流。對於追求敏捷開發和程式碼品質的團隊而言，深入掌握Git的核心概念和最佳實踐至關重要。玄貓認為，Git不僅僅是一個工具，更是現代軟體工程的根本，值得所有開發者投入時間學習和精通。
