1. 什麼是分支及其用途?
在 Git 裡使用 branches 是版本控制的一個關鍵面向,允許在同一倉庫裡並行維護多條開發線。分支使 Git 成為協作、實驗與管理專案不同版本的強大工具。
gitGraph
commit id: "Initial setup"
commit id: "Add base features"
branch feature/new-idea
checkout feature/new-idea
commit id: "Implement new logic"
commit id: "Refactor the logic"
checkout main
commit id: "Urgent bugfix on main"
merge feature/new-idea
commit id: "Prepare for release"
main 分出一個新分支
feature/new-idea,用來安全地開發。完成後它會再合回
main。
想像你要對專案做一個大改動或試一個高風險的實驗。沒了 Git,你可能會複製整個專案到一個新資料夾再在那裡工作。如果結果不錯再把變更搬回主資料夾,不然就刪掉複本。
Git 裡的分支也類似,但優雅很多。用寫書當例子說明:
- 你有一份完成的手稿(也就是你的主分支
main)。 - 你想寫一個替代的結局(建立新分支,例如
feature/new-idea)。 - 你在新分支寫新的結局,不會影響主手稿(在新分支工作)。
- 如果新的結局更好,就把它合併進去(做分支的
merge)。 - 不需要的草稿可以刪掉(刪除分支)。
2. 建立新分支並在其上工作
步驟 1. 打開分支管理選單。
在 IDE 的上方面板有個顯示當前分支名稱的 widget(預設是 main)。點它然後選 + New Branch。
步驟 2. 新分支名稱。
好習慣是按你要解決的任務命名分支。例如 feature/add-usage-examples。
建立分支後 IDE 會自動切換過去。你會在同一個 widget 裡看到新的名稱。
步驟 3. 做出改動並 commit。
現在你在自己的「沙盒」了。假設要在 README.md 裡加入使用範例的新章節。做出改動然後像上一堂課學的那樣做 commit。
3. 在分支間切換
你在 feature/add-usage-examples 的改動已安全儲存。現在回到主分支 main 看看那邊的情況。
步驟 1. 再次點當前分支名稱的 widget。
步驟 2. 在 Local 或 Recent 清單裡選 main,在彈出的子選單中點 Checkout。
步驟 3. 檢查結果。
切換後打開 README.md,你會發現沒有新增的使用範例章節!那部分還在另一個分支。這就是你能在不影響 main 穩定版本前提下開發新功能的原因。
4. 合併分支(Merge)
命令 merge 會把來自 feature/add-examples 的所有 commit(例如這裡的 C3)合併到當前分支 main,並產生一個新的合併提交。
gitGraph
commit id: "C1"
commit id: "C2"
branch feature/add-examples
checkout feature/add-examples
commit id: "C3: Add new section"
checkout main
merge feature/add-examples
所以,當你在 feature/add-usage-examples 完成任務,想把改動加到主專案時:
步驟 1. 切到目標分支。
確保你在想把改動合入的那個分支,這裡是 main。
步驟 2. 執行合併。
再點分支管理 widget。在清單中選你要從哪個分支拿改動(feature/add-usage-examples),在子選單裡選 Merge 把 feature/add-usage-examples 合到 main。
步驟 3. 檢查結果。
現在在 main 的 README.md 裡會出現你新增的使用範例章節。你已成功把工作合併進主版本!
5. 合併衝突:別怕,這很正常!
有時候在合併分支時會出現 衝突。當同一個檔案的同一行在兩個分支都被改了,Git 無法自動決定哪個版本正確,就需要你介入處理。
gitGraph
commit id: "C1: Common base"
branch feature/new-title
checkout main
commit id: "C2: Change in main"
checkout feature/new-title
commit id: "C3: Change in feature"
main 和
feature/new-title 在共同祖先 (C1) 基礎上各有新提交 (C2 和 C3)。這通常會在合併時導致衝突。
來模擬一個衝突:
- 確保你在
main分支,且沒有未暫存的變更。 - 立刻建立一個新分支
feature/new-title,但暫時不要切換過去。確保 "Checkout branch" 的勾選是取消的。 - 現在仍在
main,把README.md的第一行改成 "My Awesome Project" 並做commit。 - 切換到
feature/new-title。你會看到README.md的第一行還是舊的(建立分支時的狀態)。把同一行改成 "My Super Project" 並做commit。 - 回到
main,並執行合併feature/new-title。
此時 Git 會看到兩個分支從共同祖先開始有各自新的歷史,且同一行在兩邊都被改過,Git 無法自動選擇,就會顯示一個介面讓你解決衝突。
Merge Revision
你會看到:
- 左邊 (Your changes): 來自你當前分支(
main)的檔案版本。 - 右邊 (Changes from branch...): 要合併進來的分支的檔案版本。
- 中間 (Result): 你需要組合成的最終檔案內容。
你可以按箭頭 >> 或 <<,把整個版本接受過來。
當中間面板的結果滿意後,按 Apply。IDE 會幫你建立合併提交,衝突就解決了。
為什麼可能沒看到衝突?
有時按步驟走完並沒有衝突,通常是因為 Git 做了 fast-forward merge:某個分支的歷史只是接續了另一個分支的歷史。要保證出現衝突,兩個分支的歷史必須從共同祖先開始向不同方向演進。
例子:
- 你在
main有一個提交 C1。 - 你在
main做一個新提交,內容是 "My Awesome Project",使 main 指向 C2(main -> C1 -> C2)。 - 你從當前的 main 創一個分支
feature/new-title,因此新分支也從 C2 開始。 - 你在
feature/new-title做了一個提交 "My Super Project",現在該分支向前到 C3(feature/new-title -> C1 -> C2 -> C3)。 - 你回到還停在 C2 的
main,要求合併 feature/new-title。
Git 看出來 main 是 feature/new-title 的直接祖先,main 沒有新的提交要合入,所以可以直接把 main 的指標移到 C3,這就是 fast-forward,沒衝突可言。
gitGraph
commit id: "C1"
commit id: "C2"
branch feature/new-title
checkout feature/new-title
commit id: "C3"
checkout main
merge feature/new-title
6. 檢視變更歷史
為了更好理解專案發生了什麼,查看歷史很有幫助。
打開 IDE 底部的 Git 標籤並選 Log。你會看到所有分支和提交的圖形化表示。這能幫你清楚追蹤哪個分支從哪裡分出、在哪裡合併。
你可以點任何一個提交來看裡面包含了哪些改動、誰在何時做的。這就像程式碼的時間機器!
GO TO FULL VERSION