Git 基礎操作與版本控制最佳實務

– 12 分鐘閱讀

版本控制系統對於現代軟體開發至關重要，有效管理程式碼變更歷史並促進團隊協作。Git 作為目前最流行的版本控制系統，具備分支管理、快速操作和豐富功能等優勢。本文將介紹 Git 的基礎操作，包含提交程式碼、使用標籤、分支管理以及遠端同步等，並探討版本控制的必要性以及 Git 的優勢，涵蓋多人協作、歷史追蹤、程式碼管理等導向，幫助開發者有效運用 Git 提升開發效率和程式碼品質。理解版本控制系統出現前的軟體開發流程，有助於瞭解 Git 的價值。早期開發環境中，程式碼的變更追蹤和協作開發相當繁瑣，容易出錯。Git 等版本控制系統的出現解決了這些問題，提供程式碼備份、變更追蹤、版本標記、協同編輯等功能。Git 的普及也歸功於其創始人 Linus Torvalds 的影響力以及 Git 本身優秀的設計，尤其在分支管理方面表現出色。文章中也提供了一些基礎 Git 指令練習，幫助讀者快速上手，並透過案例研究和實務應用，展示 Git 在實際專案中的運用。最後，文章也探討了 Git 在持續整合、微服務架構和自動化測試等方面的未來趨勢，並提出一些關於分支管理策略和簡化操作的觀點。

DevOps 慣例產生出品質更高、開發成本更低且更頻繁交付給使用者

Git 基本命令實踐

為什麼選擇 Git？

在探討 Git 的基本命令之前，讓我們先來瞭解為什麼版本控制系統如 Git 對於軟體開發是如此重要。版本控制系統能夠記錄程式碼的變更歷史，並且允許多個開發者同時在同一個專案上工作，而不會互相干擾。這使得協同開發變得更加高效，並且能夠更容易地追蹤和管理程式碼的變更。

Git 是目前最流行的版本控制系統之一，因為它具有高效的分支管理、快速的操作速度以及豐富的功能。GitLab 是建立在 Git 基礎上的工具，提供了更友好的使用介面和更多的功能擴充套件，使得開發者可以更輕鬆地使用 Git。

將程式碼提交以保持安全

提交程式碼是保持程式碼安全和可追蹤的一個基本操作。每次提交都會記錄程式碼的當前狀態，包括所有的變更和註解。這樣可以確保即使發生錯誤或需要回復到之前的版本時，也能夠輕鬆找到並還原。

以下是一些基本的 Git 命令來提交程式碼：

# 顯示當前工作區狀態
git status

# 新增所有變更到暫存區
git add .

# 提交變更並附上註解
git commit -m "Your commit message"

內容解密：

  • git status：這個命令會顯示當前工作區的狀態，包括哪些檔案被修改過、新增過或刪除過。
  • git add .：這個命令會將所有變更新增到暫存區。點 . 表示當前目錄下所有檔案。
  • git commit -m "Your commit message"：這個命令會將暫存區中的變更提交到本地儲存函式庫中，並附上一個簡短的註解。

標記提交以識別程式碼版本

在開發過程中，我們經常需要標記某些特定的提交以便於後續參考或釋出。這些標記通常稱為「tag」，可以用來標識釋出版本（如 v1.0、v2.0 等）。

以下是一些基本的 Git 命令來標記提交：

# 列出所有標記
git tag

# 為當前提交建立一個新標記
git tag -a v1.0 -m "Version 1.0 release"

# 推播標記到遠端儲存函式庫
git push origin v1.0

內容解密：

  • git tag：這個命令會列出所有已存在的標記。
  • git tag -a v1.0 -m "Version 1.0 release"：這個命令會為當前提交建立一個新標記 v1.0，並附上一個簡短的註解。
  • git push origin v1.0：這個命令會將標記推播到遠端儲存函式庫中。

分支程式碼以在隔離空間中開發

在團隊合作中，我們經常需要在不同的功能或修補程式上同時工作。這時候就需要使用分支來隔離不同的開發工作，避免互相干擾。

以下是一些基本的 Git 命令來管理分支：

# 列出所有分支
git branch

# 建立一個新分支
git branch feature-branch

# 切換到指定分支
git checkout feature-branch

# 建立並切換到新分支（合併兩步操作）
git checkout -b feature-branch

內容解密：

  • git branch：這個命令會列出所有已存在的分支。
  • git branch feature-branch：這個命令會建立一個名為 feature-branch 的新分支。
  • git checkout feature-branch：這個命令會切換到名為 feature-branch 的分支。
  • git checkout -b feature-branch：這個命令會建立一個名為 feature-branch 的新分支並立即切換到該分支。

同步本地和遠端資源函式庫副本

在團隊合作中，我們需要經常將本地資源函式庫與遠端資源函式庫進行同步，以確保所有開發者都能夠存取最新的程式碼。

以下是一些基本的 Git 命令來同步資源函式庫：

# 推播本地分支到遠端資源函式庫
git push origin feature-branch

# 提取遠端資源函式庫中的更新到本地
git pull origin feature-branch

# 取回遠端資源函式庫中的更新但不進行合併
git fetch origin

內容解密：

  • git push origin feature-branch：這個命令會將本地名為 feature-branch 的分支推播到遠端資源函式庫中。
  • git pull origin feature-branch：這個命令會從遠端資源函式庫中提取名為 feature-branch 的更新並且本地分支合併。
  • git fetch origin：這個命令會從遠端資源函式庫中取回更新但不進行合併。

其他學習 Git 的資源

Git 是一個強大且複雜的工具，以上僅介紹了一些基本操作。如果你想深入學習 Git，以下是一些推薦的資源：

  1. Git Documentation：官方檔案提供了詳細的命令和使用範例。
  2. Pro Git Book：這是一本免費的線上書籍，涵蓋了 Git 的各種高階功能和最佳實踐。
  3. [Git Immersion](http://gitimmersion.com/）：一個互動式教學網站，適合初學者快速上手。

此圖示提供了一個完整 Git 操作流程示意圖：

  graph TD;
    A[初始化儲存函式庫] --> B[新增檔案];
    B --> C[提交變更];
    C --> D[建立分支];
    D --> E[切換分支];
    E --> F[推播到遠端];
    F --> G[提取更新];
    G --> H[合併變更];
    H --> I[標記版本];

此圖示展示了從初始化儲存函式庫開始，經過新增檔案、提交變更、建立分支、切換分支、推播到遠端、提取更新、合併變更以及標記版本等一系列操作流程。每一步都對應著具體的 Git 命令，幫助開發者理解整體工作流程及其邏輯關係。

為什麼使用 Git？

在進行技術實作之前，有一個選擇性但建議的步驟是組態 Git 使用 main 而不是 master 作為新專案中預設分支的名稱。雖然我們尚未討論分支的概念，但這裡只需瞭解許多軟體公司正在轉向使用 main 作為穩定程式碼函式庫所在的名稱。無論在實務還是書籍中，你都會看到這兩個術語的使用，但如果你希望新專案使用 main，可以執行以下命令：

$ git config --global init.defaultBranch main

完成所有技術要求後，我們開始探討 Git 的實用性。正如理解自動化工具如 GitLab CI/CD 管道出現前如何構建軟體（如第一章所述），瞭解 Git 或類別似工具出現前，團隊如何協調編輯相同檔案的複雜過程同樣有幫助。這些工具旨在解決開發者面臨的許多問題，但我們只看其中一個。設想你和你的同事 Elizabeth 一起工作於同一個程式碼函式庫，並且你們都想編輯某些相同的檔案。假設這是 Git 或其他版本控制系統（VCS）出現前的時期。

早期開發環境

在這個沒有 VCS 的時代，唯一能夠寫軟體的方式是編輯一個檔案然後透過電子郵件、分享網路磁碟或可攜式磁碟進行傳輸。接著，你需要告訴 Elizabeth 她可以自由編輯這個檔案。她透過某種機制檢查它（例如在試算表中新增條目來表示她擁有檔案的控制權），並在需要時保持對檔案的控制權。如果你有新想法並想再次編輯檔案，你需要請她停止編輯並將檔案轉回給你。當她這樣做時，你需要掃描整個檔案以檢視她所做的變更，以確保不與你想要做的變更發生衝突。然後，你重複這個過程來處理每個檔案，每當其中一人想要編輯這些檔案時。你可以想象到這個過程有多麼緩慢和笨拙，以及在所有轉移擁有權過程中出錯的機會有多少！

版本控制系統（VCS）是什麼？

VCS 是一種工具，旨在使一個或多個開發者更容易地與一組檔案進行互動。它透過在特定時間點對專案中的所有檔案進行快照來實作此目的，並讓你檢視、比較和還原不同快照中的檔案。

各版本控制系統功能概述

每個 VCS 的功能略有不同，但大多數 VCS 提供以下功能：

  • 提供檔案備份，以防當前版本丟失或被意外覆寫。
  • 顯示檔案內容隨時間變化的情況。
  • 顯示誰對哪些檔案進行了哪些變更以及何時進行了變更。
  • 標記某些檔案快照以便未來參考。
  • 提供每組變更的人類可讀描述，以便團隊成員理解為什麼進行了變更。
  • 允許開發者以與其他開發者同時編輯相同檔案的方式編輯檔案。

Git 的普及

多年來已經出現了許多競爭 VCS，無論是開源還是專有軟體。其中一些最知名的例子包括 Microsoft Visual SourceSafe、CVS、Apache Subversion 和現在的 Git。由於我們稍後將解釋的一些原因，Git 已經大致佔領了 VCS 領域，成為任何沒有公司指令使用 Git 競爭者的預設 VCS。

VCS 的應用範圍

VCS 與任何電腦語言相容。例如，你可以使用相同的 VCS 管理 Java、Python 和 Ruby 的不同專案檔案。雖然我們通常將 VCS 作為幫助處理電腦語言原始碼檔案的工具，但它們也可用於軟體專案中的任何檔案，包括但不限於以下內容：

  • 檔案格式：Markdown 或 PDF
  • 組態：JSON 或 YAML
  • 測試程式碼和資料
  • 整合開發環境 (IDE) 的後設資料或組態資訊
  • 其他專案資產：圖片、影片或音訊檔

事實上，並不需要限定 VCS 只適用於軟體專案！你可以使用 Git 或任何 VCS 來管理詩集中的詩歌、食譜書中的食譜或小說中的章節。VCS 對於任何涉及電腦上的檔案專案的專案都非常有用。

VCS 能解決哪些問題？

現在瞭解了像 Git 這樣的 VCS 提供哪些功能後，你可能會想到它可以解決軟體開發者面臨的一些日常問題。以下是一些情境示範：

  1. 多人協作：當多位開發者同時工作於同一套程式碼時，VCS 能夠幫助追蹤每位成員所做的修改。
  2. 歷史追蹤：如果某次修改導致問題時，可以回撤到之前穩定版本進行修復。
  3. 責任分配：每次修改都會記錄誰做了修改以及修改原因。
  4. 資料備份：即使硬碟損壞或意外刪除檔案時，也能夠從歷史版本還原。

透過以上觀點與具體應用情境來理解 VCS 的價值與重要性。

基礎 Git 指令練習

# 初始化一個新 Git 儲存函式庫
$ git init

# 新增所有檔案到暫存區
$ git add .

# 提交暫存區中的所有變更
$ git commit -m "Initial commit"

# 檢視當前分支狀態
$ git status

內容解密：

以上範例展示了初始化新儲存函式庫、暫存區新增及提交等基本操作：

  1. $ git init：初始化新儲存函式庫。
  2. $ git add .：將所有未追蹤的變更新增到暫存區。
  3. $ git commit -m "Initial commit"：提交暫存區中的變更並附上簡短說明。
  4. $ git status：檢視當前分支狀態和未提交的變更。

掌握基本操作後才能深入學習其他進階功能。

案例研究與實踐應用

假設有一家公司正在開發一款新型 Web 應用程式：

  1. 初始化儲存函式庫：開發者首先使用 git init 初始化專案儲存函式庫。
  2. 多人協作：每位開發者都可以從主分支提取最新程式碼進行工作。
  3. 分支管理：特定功能模組由不同團隊負責開發並各自建立分支進行獨立工作。
  4. 合併請求：當各模組完成後提出合併請求並由其他成員審核後合併至主分支。
  5. 歷史追蹤：若發現問題可迅速回溯到特定提交點查詢錯誤原因並進行修正。

透過實際情境演繹操作流程與技術選型考量。

未來趨勢預測

隨著 DevOps 文化越來越普及以及 CI/CD 工具成為標準配備：

  1. 持續整合：Git 與 CI/CD 工具結合可以自動化佈署流程減少人為錯誤。
  2. 微服務架構：適應微服務架構下細粒度管理對版本控制系統提出更高需求。
  3. 自動化測試：Git Hooks 可用於自動觸發測試確保程式碼品質。

透過以上觀點可以看到 Git 在現代軟體開發中不可或缺之角色以及其未來潛力。

差異化觀點與見解

雖然 Git 在版本控制領域佔據主導地位但仍存在一些爭議如分支管理策略與指令行介面相對複雜等問題：

  1. 分支策略：不同團隊可能採取不同策略如 Git Flow、Trunk-Based Development 等需根據實際情況選擇最佳策略。
  2. 簡化操作：一些圖形化介面工具如 SourceTree 或 Github Desktop 提供較友好介面減少學習門檻。

總結而言，Git 不僅僅是工具而是一種思維模式影響現代軟體開發流程及文化變遷。

Git 為何如此受歡迎？

Git 的魅力所在

Git 是目前最受歡迎的版本控制系統（Version Control System, VCS），其普及程度遠超其他競爭對手。為什麼 Git 能夠在短時間內成為業界標準呢？以下是一些關鍵因素。

1. 優秀的血統

Git 的創始人是 Linus Torvalds，這位知名程式設計師也正是 Linux 作業系統的創始人。Git 最初是為了管理 Linux 核心的原始碼而開發的，這使得 Git 從一開始就具有高度的可靠性和穩定性。如果一個工具能夠滿足 Linux 核心開發的需求，那麼它肯定能夠應付大多數其他開發需求。

這也是為什麼 Git 在初期就獲得了廣泛的認可和信任。事實上，Linus Torvalds 在軟體開發領域的影響力不僅止於 Linux，Git 的成功也進一步證明瞭他的技術眼光和創新能力。

2. 簡單易用的分支管理

分支（branch）是 VCS 中最重要的功能之一，而 Git 在設計之初就非常注重分支的簡單性和便利性。無論是建立、使用還是合併分支，Git 都提供了直觀且高效的操作方式。

這使得開發者可以輕鬆地進行平行開發，無需擔心程式碼衝突或版本混亂。每個開發者都可以在自己的分支上進行修改，完成後再將分支合併到主分支中。這種模式不僅提高了開發效率，還降低了錯誤風險。

基本 Git 指令練習

一、多人協作編輯同一檔案

假設你和同事需要同時編輯 Foo.java，這時候 VCS 的分支功能就顯得尤為重要。每個開發者都有自己的分支，可以自由地修改任何檔案，而不會影響到其他人的工作。

當每個人完成自己的任務後，只需將自己的分支合併到主分支中即可。這樣，多個開發者可以同時編輯同一個檔案，而不會出現衝突或丟失工作成果。

二、佈署特定版本的程式碼

有時候你可能需要佈署特定日期的程式碼到生產環境中。例如，你需要佈署上週五的程式碼版本。VCS 提供了標記（tag）功能，可以方便地標記特定版本的程式碼。

這樣，當你需要回復到某個已知穩定版本時，只需簡單地查詢並還原該標記即可。這對於維護和除錯非常有幫助。

Git 的實際應用場景

一、瞭解程式碼變更原因

有時候你可能會發現某個方法的演算法突然改變了，這時候你可以透過檢視 VCS 的提交訊息來瞭解變更原因。雖然不同開發者的提交訊息品質不同，但通常你都能獲得變更的大致動機。

二、追蹤程式碼變更時間

假設你幾個月沒有檢視某個 Java 類別了，突然發現它有新增或刪除了一些功能。這時候 VCS 的提交日誌可以告訴你這些變更是在什麼時候進行的，甚至是哪些行被修改了。

這樣你就能確定當前客戶使用的是哪個版本的類別。

三、追蹤 Bug 源頭

Git 的 blame 功能可以告訴你哪位開發者修改了哪些行程式碼。這對於找出問題源頭非常有幫助。如果發現新增的程式碼有問題，你知道該找誰來修復；如果發現有很巧妙的程式碼片段，你也知道該向誰學習。

使用 VCS 的好處

一、還原丟失檔案

很多人可能會不小心刪除工作了一整天的檔案。VCS 提供了簡單的方式來還原丟失檔案。只要你定期將變更提交到 VCS 中，還原丟失檔案就是小菜一碟。

二、回復到特定版本

不僅僅是還原最後一次變更，VCS 還允許你還原任何歷史版本的檔案。例如，如果你花了幾小時重寫自動測試但結果並不好，你可以輕鬆地回復到之前的版本。

說明：Git 的優勢與實用性

Git 不僅僅是一個版本控制工具，它還提供了強大的協作功能和歷史追蹤能力。無論是多人協作還是單人開發，Git 都能大大提升工作效率和程式碼品質。透過學習和使用 Git ，你將能夠更好地管理你的程式碼和專案歷史。

玄貓

玄貓

技術愛好者，專注於分享程式開發、雲端技術與 AI 應用的心得體會。