Git分支詳解：主分支（main/master）與功能分支的區別 - 夜雨飄零

git Git分支詳解主分支main 功能分支開發 Git版本控制分支使用場景 2025-12-08 50 閱讀

在Git版本控制系統中，分支是我們管理代碼的重要工具。它能讓我們在不影響主程序穩定性的前提下，並行開發新功能、修復bug，就像在一條主路上開闢出臨時的“支路”，完成後再回到主路。其中，主分支（main/master） 和 功能分支 是最核心的兩種分支類型，它們的區別和使用場景直接影響項目的開發效率和代碼質量。

爲什麼需要分支？¶

想象一下：如果所有人都在同一條“主路”上開車（比如直接在主分支寫代碼），一旦有人出了岔子（比如代碼沒寫完就提交、測試失敗），整個項目的進度都會被卡住。而分支就像“高速公路的匝道”，每個人可以在自己的匝道（功能分支）上開發，互不干擾，完成後再合併回主路（主分支），這樣主路始終保持暢通。

一、主分支（main/master）：項目的“定海神針”¶

1. 主分支是什麼？¶

主分支是項目的“核心主幹”，通常命名爲 main（現代Git項目推薦）或 master（舊項目常用）。它保存的是項目隨時可以部署到生產環境的穩定版本，就像一個已經驗收合格的“成品倉庫”。

2. 主分支的特點¶

穩定可靠：主分支的代碼必須經過充分測試，確保無bug，能直接運行（比如網站上線的代碼版本）。
只接收合併：永遠不要在主分支上直接寫代碼！主分支是“只讀”的，只能作爲功能分支合併的目標（比如新功能開發完成後，合併到主分支）。
長期存在：主分支會隨着項目迭代持續更新，是項目的最終版本來源。

3. 主分支的作用¶

生產環境基準：部署到線上的代碼必須從主分支拉取，確保用戶使用的是穩定版本。
合併目標：所有新功能、修復的bug最終都要通過合併到主分支，才能“正式上線”。

二、功能分支：開發新功能的“臨時支路”¶

1. 功能分支是什麼？¶

功能分支是爲了開發新功能、修復bug而創建的臨時分支，通常命名爲 feature/xxx（如 feature/login）、bugfix/xxx（如 bugfix/error-handling）。它從主分支創建，完成後合併回主分支，合併後功能分支可以刪除。

2. 功能分支的特點¶

臨時隔離：在功能分支上開發，不會直接影響主分支的穩定性（比如你寫的代碼沒測試通過，主分支依然可用）。
專注開發：一個功能分支只負責一個任務（比如只寫登錄功能），避免多個功能在同一分支混亂。
完成即棄：功能分支的生命週期從創建到合併回主分支後結束，可刪除以保持分支整潔。

3. 功能分支的作用¶

並行開發：多人可以同時在不同的功能分支上開發（比如A開發登錄，B開發註冊），互不干擾。
風險隔離：如果功能分支的代碼有問題，不會影響主分支的穩定；測試通過後再合併，保證主分支“乾淨可用”。

三、主分支 vs 功能分支：核心區別¶

對比項	主分支（main/master）	功能分支（如 feature/xxx）
作用	項目穩定版本，生產環境部署	開發新功能、修復bug的臨時任務
創建來源	永遠是“源頭”，所有分支從它創建	必須從主分支創建
代碼狀態	穩定、可運行、無未完成代碼	臨時、可能未測試或未完成
修改方式	只能接受合併，不能直接修改	可自由開發、提交、測試
生命週期	長期存在，持續迭代	臨時存在，合併後刪除

四、新手必知：正確使用分支的場景¶

❌ 錯誤示例：直接在主分支開發¶

如果直接在主分支寫代碼，比如你剛寫了一半的“購物車功能”，突然發現主分支的某個bug需要緊急修復，這時候如果直接在主分支改bug，會導致購物車功能的代碼和bug修復的代碼混在一起，後續測試時容易出錯。

✅ 正確示例：功能分支開發流程¶

從主分支創建功能分支：
先確保主分支是最新的，然後創建功能分支：

   git checkout main   # 切換到主分支
   git pull            # 拉取最新主分支代碼
   git checkout -b feature/shopping-cart  # 創建並切換到購物車功能分支

在功能分支開發：
在 feature/shopping-cart 分支上寫代碼、提交：

   git add .           # 添加修改
   git commit -m "完成購物車頁面UI"  # 提交代碼

測試通過後合併回主分支：
功能完成後，合併到主分支：

   git checkout main   # 切換回主分支
   git merge feature/shopping-cart  # 合併功能分支到主分支
   git push origin main  # 推送到遠程倉庫

刪除功能分支：
合併完成後，功能分支任務結束，可以刪除：

   git branch -d feature/shopping-cart  # 刪除本地功能分支
   git push origin --delete feature/shopping-cart # 刪除遠程功能分支

總結：主分支是根基，功能分支是“翅膀”¶

主分支 是項目的“定海神針”，必須保持穩定，是最終用戶使用的版本來源。
功能分支 是開發的“實驗田”，讓我們在不影響主分支的前提下自由探索、測試新功能。

記住：永遠不要在主分支寫未完成的代碼！功能分支用完即合併、即刪除，這樣才能讓你的項目既高效又穩定。下次開發時，試試用分支隔離你的任務吧！

小夜