Git 分支操作

分支操作主要有以下五大指令，扣掉複雜的 rebase 以外其餘根本不需要每個寫成一篇文章來介紹。本文只會有本地不會有遠端操作，遠端操作的第一篇文章要從遠端儲存庫設定開始。

git branch                           # 分支操作
git switch                           # 切換分支
git stash                            # 暫存檔案（非預存）
git rebase                           # 任意修改提交歷史
git revert                           # 恢復提交

分支 git branch

分支用於開發新功能、問題修復、或者是準備發佈新版本。

git branch                           # 查看分支清單
git branch <name>                    # 新建分支
git switch <name>                    # 切換到分支，等效於為 git checkout <name>

git branch -D <name>                 # 刪除
git branch -m <old> <new>            # 改名

切換 git switch

git switch 是專門用來切換分支的新版指令，比傳統的 git checkout 更明確，因為 git checkout 太過萬能。

git switch branch_name               # 切換到現有分支
git switch -d commit_hash            # 分離模式，用於臨時查看、不建立分支的切換，d=detach
git switch -c <new-name>             # 建立新分支並切換
git switch -c <new-name> <hash>      # 從指定的提交建立並切換

使用 checkout 來切換分支也是沒問題的，完全沒有任何差別，指令也大同小異不重複介紹。

暫存 git stash

這是一個特別的指令，會把目前所有尚未提交的檔案放進獨立的暫存空間中，使用情境主要有以下幾個：

使用 git checkout/switch/rebase 時目錄不能有未提交檔案，可以用他暫存
改到一半需要改一個更重要的東西
改到一半需要跳到別的分支

可以看出都是暫時，是擋刀用的指令。

基本選項：

# 基本上只要記得前三個用法
git stash                            # 暫存變更
git stash -- <pathspec>              # 暫存指定檔案
git stash pop                        # 還原暫存並且移除紀錄，等同 apply + drop
git stash list                       # 查看暫存清單

# 比較少用的方式
git stash push -m "my_stash_name"    # 幫暫存取名（只是讓你查看名稱，不支援從名稱恢復）
git stash apply stash@{0}            # 恢復第一個暫存
git stash drop stash@{0}             # 刪除第一個暫存
git stash clear                      # 清除所有暫存

看不懂 pathspec？請見看懂文檔。

合併 git merge

分久必合，有了分支下一步就是合併，git merge 是最淺顯易懂的合併方式。使用時我們一般來說都會先進入主分支以合併子分支，指令如下：

git switch main
git merge feature-branch

這樣就會把 feature-branch 的修改全部加在 main 分支中，並且建立一個新的提交用於記錄合併。git merge 預設模式是 fast-forward，意思是兩者的分支結構完全相同時，只會將目前分支的 HEAD 向前移動，不會建立新的用於記錄合併的提交。我們可以使用 --no-ff 關閉此模式，下方是兩者的差異示意圖：

# 初始狀態
  A---B---C  main
           \
            D---E---F  feature-branch

使用 Fast-Forward 的結果如下：

# 使用 Fast-Forward，直接把 main 從 C 移動到 F
# git merge feature-branch
  A---B---C---D---E---F  main and feature-branch

不使用 Fast-Forward 的則會新增一個專門用來紀錄合併的提交 G：

# 使用 --no-ff，建立記錄合併的提交 G
# git merge --no-ff feature-branch
  A---B---C-----------G  main
           \         /
            D---E---F  feature-branch

兩者的選擇端看是否需要保存分支結構。合併時可能會遇到衝突，這需要手動解決，解決方式請看如何解決合併衝突。

變基 git rebase

先解釋名詞變基，意思是「變換」目前分支的「基底」，用於取代 git merge，目的是簡化提交歷史，避免到處都是合併的結構導致閱讀和管理困難。由於比較複雜只講解他的基本邏輯：

口訣

比較「目前分支」和「目標分支」把「目前分支」的提交移動到「目標分支」之後

為了搞懂 rebase 看了很多文章，最後濃縮成這兩句話¹，使用教學請見本教學的使用變基 Rebase 合併分支。

如何解決合併衝突？

任意修改提交歷史 git rebase -i

互動式變基 (interactive rebase) 使用變基的原理實現對提交歷史進行任意修改，同時使用方式非常簡單，請見使用互動式變基任意修改提交歷史。

危險

git rebase -i 會修改歷史，再次強調修改提交歷史 永遠只該用於個人分支！

變基時可能會遇到衝突，解決方式請見如何解決合併衝突。

恢復 git revert

用實際案例講解比較簡單。假設現在想撤銷提交 A，但是由於團隊合作最好別修改提交歷史，我們可以用 git revert 提交一個 negative A，這樣會產生一個新的提交把提交 A 抵銷，也不用修改歷史。

放在這裡的原因是團隊合作才會用到，一個人的話想怎麼改就怎麼改。

結語

到這邊你已經熟悉 Git 的所有常用指令了，只是需要一點時間熟悉，下一步請快轉到遠端儲存庫設定，進階文章初學者用不到建議暫時跳過以免越看越亂。

附帶一提，濃縮後還是正確的，網路上很多文章講的又臭又長結果還是講錯真的是來搞笑的，而且 git rebase 如果使用方式正確就不會修改到主分支的提交歷史和 hash，如果改變就代表用錯了，網路上就有滿山滿谷的錯誤教學，這些人不知道是有沒有發現自己錯，總之是沒幾個人回去修正自己的文章。 ↩

分支 git branch​

切換 git switch​

暫存 git stash​

合併 git merge​

變基 git rebase​

任意修改提交歷史 git rebase -i​

恢復 git revert​

結語​

Footnotes​