CodeGym /課程 /C# SELF /安全的實驗:使用分支開發

安全的實驗:使用分支開發

C# SELF
等級 26, 課堂 2
開放

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 裡的分支也類似,但優雅很多。用寫書當例子說明:

  1. 你有一份完成的手稿(也就是你的主分支 main)。
  2. 你想寫一個替代的結局(建立新分支,例如 feature/new-idea)。
  3. 你在新分支寫新的結局,不會影響主手稿(在新分支工作)。
  4. 如果新的結局更好,就把它合併進去(做分支的 merge)。
  5. 不需要的草稿可以刪掉(刪除分支)。

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)。這通常會在合併時導致衝突。

來模擬一個衝突:

  1. 確保你在 main 分支,且沒有未暫存的變更。
  2. 立刻建立一個新分支 feature/new-title,但暫時不要切換過去。確保 "Checkout branch" 的勾選是取消的。
  3. 現在仍在 main,把 README.md 的第一行改成 "My Awesome Project" 並做 commit。
  4. 切換到 feature/new-title。你會看到 README.md 的第一行還是舊的(建立分支時的狀態)。把同一行改成 "My Super Project" 並做 commit。
  5. 回到 main,並執行合併 feature/new-title。

此時 Git 會看到兩個分支從共同祖先開始有各自新的歷史,且同一行在兩邊都被改過,Git 無法自動選擇,就會顯示一個介面讓你解決衝突。

Merge Revision

你會看到:

  • 左邊 (Your changes): 來自你當前分支(main)的檔案版本。
  • 右邊 (Changes from branch...): 要合併進來的分支的檔案版本。
  • 中間 (Result): 你需要組合成的最終檔案內容。

你可以按箭頭 >> 或 <<,把整個版本接受過來。

當中間面板的結果滿意後,按 Apply。IDE 會幫你建立合併提交,衝突就解決了。

為什麼可能沒看到衝突?

有時按步驟走完並沒有衝突,通常是因為 Git 做了 fast-forward merge:某個分支的歷史只是接續了另一個分支的歷史。要保證出現衝突,兩個分支的歷史必須從共同祖先開始向不同方向演進。

例子:

  1. 你在 main 有一個提交 C1。
  2. 你在 main 做一個新提交,內容是 "My Awesome Project",使 main 指向 C2(main -> C1 -> C2)。
  3. 你從當前的 main 創一個分支 feature/new-title,因此新分支也從 C2 開始。
  4. 你在 feature/new-title 做了一個提交 "My Super Project",現在該分支向前到 C3(feature/new-title -> C1 -> C2 -> C3)。
  5. 你回到還停在 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。你會看到所有分支和提交的圖形化表示。這能幫你清楚追蹤哪個分支從哪裡分出、在哪裡合併。

你可以點任何一個提交來看裡面包含了哪些改動、誰在何時做的。這就像程式碼的時間機器!

留言
TO VIEW ALL COMMENTS OR TO MAKE A COMMENT,
GO TO FULL VERSION