Git
Chapters ▾ 2nd Edition

2.5 Git 基礎 - 與遠端協同工作

與遠端協同工作

為了能在任意的 Git 專案上協同工作,你需要知道如何管理你的遠端版本庫。 遠端版本庫是指被託管在網際網路或其他網路中的各種專案版本庫。 你可以擁有許多遠端版本庫;通常來說,它如果不是唯讀的,就是可讀寫的。 與其它人協同工作包括了:「管理」遠端版本庫、以及將分享的資料「推送(push)」到端遠版本庫、或者從遠端版本庫「拉取(pull)」分享的資料: 管理遠端版本庫則包括了了解如何:「新增」遠端版本庫、「移除」不再有效的遠端版本庫、管理各式各樣的「遠端分支」、定義遠端分支是否被「追蹤」等等。 我們將在這一節介紹這些遠端管理技巧。

顯示你的遠端

使用 git remote 命令可以檢視你已經設定好的遠端版本庫, 它會列出每個遠端版本庫的「簡稱」。 如果你克隆(clone)了一個遠端版本庫,你至少看得到「origin」——它是 Git 給定的預設簡稱,用來代表被克隆的來源。

$ git clone https://github.com/schacon/ticgit
Cloning into 'ticgit'...
remote: Reusing existing pack: 1857, done.
remote: Total 1857 (delta 0), reused 0 (delta 0)
Receiving objects: 100% (1857/1857), 374.35 KiB | 268.00 KiB/s, done.
Resolving deltas: 100% (772/772), done.
Checking connectivity... done.
$ cd ticgit
$ git remote
origin

你也可以指定 -v 選項來顯示 Git 用來讀寫遠端簡稱時所用的網址。

$ git remote -v
origin	https://github.com/schacon/ticgit (fetch)
origin	https://github.com/schacon/ticgit (push)

如果遠端版本庫不止一個,這個命令會將它們全部列出來。 例如,一個版本庫內連結了許多其它協作者的遠端版本庫,可能看起來就像這樣:

$ cd grit
$ git remote -v
bakkdoor  https://github.com/bakkdoor/grit (fetch)
bakkdoor  https://github.com/bakkdoor/grit (push)
cho45     https://github.com/cho45/grit (fetch)
cho45     https://github.com/cho45/grit (push)
defunkt   https://github.com/defunkt/grit (fetch)
defunkt   https://github.com/defunkt/grit (push)
koke      git://github.com/koke/grit.git (fetch)
koke      git://github.com/koke/grit.git (push)
origin    git@github.com:mojombo/grit.git (fetch)
origin    git@github.com:mojombo/grit.git (push)

這意味著我們可以很輕鬆地拉取任何協作者的貢獻; 我們可能對其中某些遠端版本庫還擁有推送權限,不過我們不會在這裡詳述這個部分。

注意:這些遠端版本庫使用了不同的通訊協定;我們將會在 在伺服器上佈署 Git 對它有更多的說明。

新增遠端版本庫

我們在之前的章節中已經提過並給了一些範例來說明 clone 命令如何隱式地為你加入 origin 遠端; 而在這裡將說明如何「明確地」新增一個遠端。 選一個你可以輕鬆引用的簡稱,用來代表要新增的遠端 Git 版本庫,然後執行 git remote add <簡稱> <url> 來新增它:

$ git remote
origin
$ git remote add pb https://github.com/paulboone/ticgit
$ git remote -v
origin	https://github.com/schacon/ticgit (fetch)
origin	https://github.com/schacon/ticgit (push)
pb	https://github.com/paulboone/ticgit (fetch)
pb	https://github.com/paulboone/ticgit (push)

現在你可以在命令列中使用 pb 這個字串來代表整個網址; 例如,如果你想從 Paul 的版本庫中取得所有資訊,而這些資訊並不存在於你的版本庫中,你可以執行 git fetch pb

$ git fetch pb
remote: Counting objects: 43, done.
remote: Compressing objects: 100% (36/36), done.
remote: Total 43 (delta 10), reused 31 (delta 5)
Unpacking objects: 100% (43/43), done.
From https://github.com/paulboone/ticgit
 * [new branch]      master     -> pb/master
 * [new branch]      ticgit     -> pb/ticgit

現在 Paul 的 master 分支可以在本地端透過 pb/master 存取到(譯註:把 pb/master 想成 Paul 的 master 在你本地端的「分身」——實際上它被稱為「遠端追蹤分支(remote-tracking branch)」)——你可以把它合併(merge)到你的其中一個分支;或者,如果你想要檢視它的話,可以在它身上檢出(checkout)一個本地分支。 (我們將會在 使用 Git 分支 中詳細介紹什麼是分支以及如何使用它們。)

從你的遠端獲取或拉取

如同你剛剛所看到的,要從你的遠端專案中取得資料,你可以執行:

$ git fetch [remote-name]

這個命令會連到遠端專案,然後從遠端專案中將你還沒有的資料全部拉下來; 執行完成後,你應該會有那個遠端版本庫中所有分支的參照(reference)(譯註:再次強調,遠端的分支在本地端的分身——遠端追蹤分支),可以隨時用來合併或檢視。

如果你克隆了一個版本庫,clone 命令會自動增加一個「origin」來代表遠端版本庫; 所以,git fetch origin 會獲取(fetch)在你克隆(或者最後一次獲取)之後任何被推送到伺服器上的新的工作內容。 很重要的一點是:git fetch 命令只會下載資料到你的版本庫——它並不會自動合併你的任何工作內容,也不會自動修改你正在修改的東西; 當你準備好合併你的工作內容時,你必需用手動的方式進行合併。

如果你的目前分支被設定為「追蹤」遠端上的分支(閱讀下一節以及 使用 Git 分支 以了解更多資訊),你便可使用 git pull 命令來自動「獲取」並「合併」那個遠端分支到你目前的分支裡去; 由於 git clone 命令會「自動地」將本地分支 master 設定為「追蹤」遠端上的 master(無論預設分支叫什麼名稱。譯註:只要是預設分支都會自動設定追踨行為,而 master 常常是預設分支),這可能會讓你有比較輕鬆自在的工作流程: 只要執行 git pull 通常就會從你最初克隆的伺服器上獲取資料,然後試著自動合併到目前的分支。

推送到你的遠端

當你想分享你的專案成果時,你必需將它推送到上游。 推送的命令很簡單:git push [remote-name] [branch-name]。 如果你想要將 master 分支推送到 origin 伺服器上時(再次說明,克隆時通常會自動地幫你設定好 masterorigin 這二個名稱),那麼你可以執行這個命今將所有你完成的提交(commit)推送回伺服器上。

$ git push origin master

只有在你對克隆來源的伺服器有寫入權限,並且在這個當下還沒有其它人推送過,這個命令才會成功; 如果你和其它人同時做了克隆,然後他們先推送到上游,接著換你推送到上游,毫無疑問地你的推送會被拒絕; 你必需先獲取他們的工作內容,將其整併到你之前的工作內容,如此你才會被允許推送。 閱讀 使用 Git 分支 以了解更多關於「如何推送到遠端伺服器」的詳細資訊。

檢視遠端

如果你想要對一個特定遠端檢視更多資訊,你可以使用 git remote show [remote-name] 命令。 如果你在執行這個命令中使用特定的簡稱,例如 origin,你會得到下面這個類似的訊息:

$ git remote show origin
* remote origin
  Fetch URL: https://github.com/schacon/ticgit
  Push  URL: https://github.com/schacon/ticgit
  HEAD branch: master
  Remote branches:
    master                               tracked
    dev-branch                           tracked
  Local branch configured for 'git pull':
    master merges with remote master
  Local ref configured for 'git push':
    master pushes to master (up to date)

它同時列出了遠端版本庫的網址和「追蹤分支(tracking branch)」資訊。 這個命令很有用地告訴你:目前分支是 master(譯注:HEAD 意味著目前的),如果你執行 git pull,它會在獲取所有遠端參照之後,自動將遠端的 master 合併到你的 master 分支。 它也會列出所有已抓下來的遠端參照(譯註:此例中指「master tracked」和「dev-branch tracked」)。

這是一個你很可能會遇到的簡單例子; 然而,當你更重度地使用 Git 後,你將會從 git remote show 中看到更多的資訊:

$ git remote show origin
* remote origin
  URL: https://github.com/my-org/complex-project
  Fetch URL: https://github.com/my-org/complex-project
  Push  URL: https://github.com/my-org/complex-project
  HEAD branch: master
  Remote branches:
    master                           tracked
    dev-branch                       tracked
    markdown-strip                   tracked
    issue-43                         new (next fetch will store in remotes/origin)
    issue-45                         new (next fetch will store in remotes/origin)
    refs/remotes/origin/issue-11     stale (use 'git remote prune' to remove)
  Local branches configured for 'git pull':
    dev-branch merges with remote dev-branch
    master     merges with remote master
  Local refs configured for 'git push':
    dev-branch                     pushes to dev-branch                     (up to date)
    markdown-strip                 pushes to markdown-strip                 (up to date)
    master                         pushes to master                         (up to date)

這個命令顯示了當你在特定的分支上執行 git push 時,它將自動推送到哪一個遠端分支; 它也顯示了:哪些遠端分支是在你的本地端還沒有的(譯註:new 屬性)、哪些你曾獲取過的遠端分支已經在遠端上被移除了(譯註:stale 屬性)、哪些本地分支是有能力在執行 git pull 後自動和它們的遠端追蹤分支合併。

移除或重新命名遠端

你可以執行 git remote rename 來重新命名遠端的簡稱。 例如:如果你想要將 pb 重新命名為 paul,你可以這樣使用 git remote rename

$ git remote rename pb paul
$ git remote
origin
paul

值得一提的是:它會更新所有遠端追蹤分支的名稱; 曾經用來被參考的遠端追蹤分支 pb/master 現在改名為 paul/master

如果你因為某些原因想要移除一個遠端——你搬動了伺服器、或者不再使用某個特定的鏡像、或者某個貢獻者不再貢獻了——你可以執行 git remote rm

$ git remote rm paul
$ git remote
origin