Learn Git

遠端分支

遠端分支(remote branch)是對遠端倉庫中的分支的索引。它們是一些無法移動的本地分支;只有在 Git 進行網路交互時才會更新。遠端分支就像是書簽,提醒著你上次連接遠端倉庫時上面各分支的位置。

我們用 (遠端倉庫名)/(分支名) 這樣的形式表示遠端分支。比如我們想看看上次同 origin 倉庫通訊時 master 分支的樣子,就應該查看 origin/master 分支。如果你和同伴一起修復某個問題,但他們先推送了一個 iss53 分支到遠端倉庫,雖然你可能也有一個本地的 iss53 分支,但指向伺服器上最新更新的卻應該是 origin/iss53 分支。

可能有點亂,我們不妨舉例說明。假設你們團隊有個地址為 git.ourcompany.com 的 Git 伺服器。如果你從這裡克隆,Git 會自動為你將此遠端倉庫命名為 origin,並下載其中所有的資料,建立一個指向它的 master 分支的指標,在本地命名為 origin/master,但你無法在本地更改其資料。接著,Git 建立一個屬於你自己的本地 master 分支,始於 originmaster 分支相同的位置,你可以就此開始工作(見圖 3-22):

圖 3-22. 一次 Git 克隆會建立你自己的本地分支 master 和遠端分支 origin/master,並且將它們都指向 origin 上的 master 分支。

如果你在本地 master 分支做了些改動,與此同時,其他人向 git.ourcompany.com 推送了他們的更新,那麼伺服器上的 master 分支就會向前推進,而於此同時,你在本地的提交歷史正朝向不同方向發展。不過只要你不和伺服器通訊,你的 origin/master 指標仍然保持原位不會移動(見圖 3-23)。

圖 3-23. 在本地工作的同時有人向遠端倉庫推送內容會讓提交歷史開始分流。

可以運行 git fetch origin 來同步遠端伺服器上的資料到本地。該命令首先找到 origin 是哪個伺服器(本例為 git.ourcompany.com),從上面獲取你尚未擁有的資料,更新你本地的資料庫,然後把 origin/master 的指針移到它最新的位置上(見圖 3-24)。

圖 3-24. git fetch 命令會更新 remote 索引。

為了演示擁有多個遠端分支(在不同的遠端伺服器上)的專案是如何工作的,我們假設你還有另一個僅供你的敏捷開發小組使用的內部伺服器 git.team1.ourcompany.com。可以用第二章中提到的 git remote add 命令把它加為當前專案的遠端分支之一。我們把它命名為 teamone,以便代替完整的 Git URL 以方便使用(見圖 3-25)。

圖 3-25. 把另一個伺服器加為遠端倉庫

現在你可以用 git fetch teamone 來獲取小組伺服器上你還沒有的資料了。由於當前該伺服器上的內容是你 origin 伺服器上的子集,Git 不會下載任何資料,而只是簡單地創建一個名為 teamone/master 的遠端分支,指向 teamone 伺服器上 master 分支所在的提交物件 31b8e(見圖 3-26)。

圖 3-26. 你在本地有了一個指向 teamone 伺服器上 master 分支的索引。

推送本地分支

要想和其他人分享某個本地分支,你需要把它推送到一個你擁有寫許可權的遠端倉庫。你創建的本地分支不會因為你的寫入操作而被自動同步到你引入的遠端伺服器上,你需要明確地執行推送分支的操作。換句話說,對於無意分享的分支,你儘管保留為私人分支好了,而只推送那些協同工作要用到的特性分支。

如果你有個叫 serverfix 的分支需要和他人一起開發,可以運行 git push (遠端倉庫名) (分支名)

$ git push origin serverfix
Counting objects: 20, done.
Compressing objects: 100% (14/14), done.
Writing objects: 100% (15/15), 1.74 KiB, done.
Total 15 (delta 5), reused 0 (delta 0)
To git@github.com:schacon/simplegit.git
 * [new branch]      serverfix -> serverfix

這裡其實走了一點捷徑。Git 自動把 serverfix 分支名擴展為 refs/heads/serverfix:refs/heads/serverfix,意為“取出我在本地的 serverfix 分支,推送到遠端倉庫的 serverfix 分支中去”。我們將在第九章進一步介紹 refs/heads/ 部分的細節,不過一般使用的時候都可以省略它。也可以運行 git push origin serverfix:serverfix 來實現相同的效果,它的意思是“上傳我本地的 serverfix 分支到遠端倉庫中去,仍舊稱它為 serverfix 分支”。通過此語法,你可以把本地分支推送到某個命名不同的遠端分支:若想把遠端分支叫作 awesomebranch,可以用 git push origin serverfix:awesomebranch 來推送數據。

接下來,當你的協作者再次從伺服器上獲取資料時,他們將得到一個新的遠端分支 origin/serverfix,並指向伺服器上 serverfix 所指向的版本:

$ git fetch origin
remote: Counting objects: 20, done.
remote: Compressing objects: 100% (14/14), done.
remote: Total 15 (delta 5), reused 0 (delta 0)
Unpacking objects: 100% (15/15), done.
From git@github.com:schacon/simplegit
 * [new branch]      serverfix    -> origin/serverfix

值得注意的是,在 fetch 操作下載好新的遠端分支之後,你仍然無法在本地編輯該遠端倉庫中的分支。換句話說,在本例中,你不會有一個新的 serverfix 分支,有的只是一個你無法移動的 origin/serverfix 指標。

如果要把該遠端分支的內容合併到當前分支,可以運行 git merge origin/serverfix。如果想要一份自己的 serverfix 來開發,可以在遠端分支的基礎上分化出一個新的分支來:

$ git checkout -b serverfix origin/serverfix
Branch serverfix set up to track remote branch serverfix from origin.
Switched to a new branch 'serverfix'

這會切換到新建的 serverfix 本地分支,其內容同遠端分支 origin/serverfix 一致,這樣你就可以在裡面繼續開發了。

跟蹤遠端分支

從遠端分支 checkout 出來的本地分支,稱為 跟蹤分支 (tracking branch)。跟蹤分支是一種和某個遠端分支有直接聯繫的本地分支。在跟蹤分支裡輸入 git push,Git 會自行推斷應該向哪個伺服器的哪個分支推送資料。同樣,在這些分支裡運行 git pull 會獲取所有遠端索引,並把它們的資料都合併到本地分支中來。

在克隆倉庫時,Git 通常會自動創建一個名為 master 的分支來跟蹤 origin/master。這正是 git pushgit pull 一開始就能正常工作的原因。當然,你可以隨心所欲地設定為其它跟蹤分支,比如 origin 上除了 master 之外的其它分支。剛才我們已經看到了這樣的一個例子:git checkout -b [分支名] [遠端名]/[分支名]。如果你有 1.6.2 以上版本的 Git,還可以用 --track 選項簡化:

$ git checkout --track origin/serverfix
Branch serverfix set up to track remote branch serverfix from origin.
Switched to a new branch 'serverfix'

要為本地分支設定不同于遠端分支的名字,只需在第一個版本的命令裡換個名字:

$ git checkout -b sf origin/serverfix
Branch sf set up to track remote branch serverfix from origin.
Switched to a new branch 'sf'

現在你的本地分支 sf 會自動將推送和抓取資料的位置定位到 origin/serverfix 了。

刪除遠端分支

如果不再需要某個遠端分支了,比如搞定了某個特性並把它合併進了遠端的 master 分支(或任何其他存放穩定代碼的分支),可以用這個非常無厘頭的語法來刪除它:git push [遠程名] :[分支名]。如果想在伺服器上刪除 serverfix 分支,運行下面的命令:

$ git push origin :serverfix
To git@github.com:schacon/simplegit.git
 - [deleted]         serverfix

咚!伺服器上的分支沒了。你最好特別留心這一頁,因為你一定會用到那個命令,而且你很可能會忘掉它的語法。有種方便記憶這條命令的方法:記住我們不久前見過的 git push [遠端名] [本地分支]:[遠端分支] 語法,如果省略 [本地分支],那就等於是在說“在這裡提取空白然後把它變成[遠端分支]”。