–set-upstream的用法詳解

一、–set-upstream簡介

–set-upstream是Git中一個重要的命令選項，其作用是將當前分支與遠程分支建立關聯關係。通過這種方式，Git可以知道當前分支與哪個遠程分支進行了協同合作，方便管理代碼的提交和同步。

二、關聯遠程分支

在Git中，我們可以通過以下命令將當前分支與指定的遠程分支建立關聯關係：

$ git branch --set-upstream-to=[remote branch] [local branch]

示例代碼：

$ git branch --set-upstream-to=origin/master master

這條命令的作用是建立本地master分支與遠程origin/master分支的關聯關係。

執行完這條命令後，可以通過git branch命令查看當前分支與哪個遠程分支建立了關聯關係：

$ git branch -vv

執行結果如下：

  master   7c66888 [origin/master] 修改README.md
* dev      9d1a786 [origin/dev]  修改index.css

可以看到，當前的master分支與遠程origin/master分支建立了關聯關係。

三、隱式關聯

在Git 1.8.0版本之後，Git提供了一種隱式關聯的方式，即在git pull命令中使用–set-upstream選項。例如：

$ git pull --set-upstream origin master

這條命令的作用是將當前分支與遠程origin/master分支建立隱式關聯關係。

這條命令等同於同時執行以下兩條命令：

$ git branch --set-upstream-to=origin/master master
$ git pull

表示將當前分支與遠程origin/master分支建立關聯關係，並且從遠程分支拉取代碼到本地。

四、關聯失敗

如果要使用–set-upstream選項建立關聯關係，必須滿足以下兩種條件之一：

1. 遠程分支與當前分支同名
2. 使用帶有「:」符號的分支名稱指定遠程分支

如果以上兩種條件都不滿足，執行–set-upstream選項會失敗，並且會提示以下錯誤信息：

fatal: The upstream branch of your current branch does not match the name of your current branch.

此時，需要手動指定遠程分支並建立關聯關係。

五、解除關聯關係

如果想要解除當前分支與遠程分支的關聯關係，可以通過以下命令實現：

$ git branch --unset-upstream [local branch]

示例代碼：

$ git branch --unset-upstream master

執行完這條命令後，當前分支與遠程分支的關聯關係被解除了。

六、總結

–set-upstream是Git中一個重要的命令選項，其作用是將當前分支與遠程分支建立關聯關係。通過建立關聯關係，可以方便地管理代碼的提交和同步。在使用–set-upstream選項時，需要注意與當前分支同名或使用帶有「:」符號的分支名稱指定遠程分支。