使用 Git 的 git switch 指令切換分支與設置追蹤：新手指南

更新日期： 2024 年 12 月 13 日

在使用 Git 和 GitHub 進行版本控制時，切換分支是日常操作之一。

git switch 是一個專門用來切換分支的指令，簡潔且高效，特別適合新手使用。

然而，它的行為因本地是否存在目標分支而不同，並且還涉及到「追蹤」遠端分支的概念。

本文將通過簡單易懂的說明，幫助您快速掌握 git switch 的基本操作及其與追蹤分支的關聯。

git switch 的兩種情況

git switch 在以下兩種情況下表現不同：

當本機已有分支時

如果目標分支已存在於本地，您可以直接切換：

git switch <branch_name>

行為

Git 會直接切換到本地的 <branch_name> 分支，不會進行其他操作。

當本機沒有該分支，但遠端有該分支時

如果目標分支僅存在於遠端，執行相同的指令：

git switch <branch_name>

行為

Git 會自動執行以下操作：

1. 創建一個新的本地分支，名稱為 <branch_name>。
2. 設置該本地分支與遠端分支的追蹤關係。
3. 切換到新建的本地分支。

執行後，您會看到提示：

Branch '<branch_name>' set up to track 'origin/<branch_name>'.
Switched to a new branch '<branch_name>'.

什麼是「追蹤」？

在 Git 中，「追蹤」指的是本地分支與遠端分支之間的關聯。

設置追蹤後，Git 可以幫助您簡化拉取（pull）和推送（push）操作。

追蹤關係的作用

1. 簡化操作
   設置追蹤關係後，您只需執行簡單指令即可同步分支，而無需明確指定遠端和分支名稱。
   
   例如：

git pull  
git push  

2. 避免混淆
   多人協作時，追蹤關係幫助您清楚地了解本地分支與遠端分支的對應關係，避免意外修改錯誤的分支。

追蹤關係的應用場景

例子：從遠端拉取一個新分支

假設遠端倉庫有一個分支 origin/issues/19，而本地尚未存在該分支。

執行以下指令：

git switch issues/19

Git 會自動執行以下操作：

1. 創建本地分支 issues/19。
2. 設置該分支追蹤 origin/issues/19。
3. 切換到本地分支 issues/19。

此後，您可以使用以下命令來同步分支：

• 拉取更新

 git pull

• 推送更改

git push

常見問題與解答

為什麼 git switch origin/issues/19 失敗？

origin/issues/19 是遠端分支的名稱，而 git switch 需要一個本地分支名稱。

因此，不能直接切換到遠端分支。

正確的操作是基於遠端分支創建本地分支：

git switch -c issues/19 origin/issues/19

這條命令會同時創建本地分支並設置追蹤關係。

如何區分本地分支與遠端分支？

使用 git branch -a 查看所有分支：

• 本地分支顯示為 branch_name（如 issues/19）。
• 遠端分支顯示為 remotes/origin/branch_name（如 remotes/origin/issues/19）。

如果遠端分支不存在，會發生什麼？

執行 git switch <branch_name> 時，如果遠端和本地都沒有該分支，Git 會提示錯誤：

error: could not find any remote branch '<branch_name>' to clone.

小結

1. git switch 的行為
   • 當本地已有分支時，直接切換。
   • 當本地沒有分支但遠端有分支時，自動創建本地分支並設置追蹤。
2. 追蹤關係的作用
   • 簡化同步操作（如 git pull 和 git push）。
   • 幫助理解本地與遠端分支的關聯。
3. 關鍵檢查指令
   • 查看當前分支的追蹤狀態：git status
   • 查看所有分支的追蹤關係：git branch -vv

掌握了這些知識後，您將能更高效地切換和管理分支，提升開發效率！