當本地 Git 倉庫的命名與遠程倉庫不一致時(shí)，與遠程倉庫協(xié)作就會(huì )變得很混亂。

解決此問(wèn)題的一個(gè)方法是標準化兩個(gè)詞的使用和含義：origin 指的是你個(gè)人的 example.com/<USER>/* 倉庫，而 upstream 指的是你從 origin 倉庫復刻fork出來(lái)的 example.com 倉庫。換句話(huà)說(shuō)，upstream 指的是公開(kāi)提交工作的上游倉庫，而 origin 指的是你對上游倉庫的本地復刻，例如，你從這里生成拉取請求pull request（PR）。

以 pbench 倉庫為例，下面是一個(gè)逐步建立新的本地克隆的方法，其中 origin 和 upstream 的定義是一致的。

1、在大多數 Git 托管服務(wù)上，當你想在上面工作時(shí)，必須對它進(jìn)行復刻。當你運行自己的 Git 服務(wù)器時(shí)，這并不是必要的，但對于一個(gè)公開(kāi)的代碼庫來(lái)說(shuō)，這是一個(gè)在貢獻者之間傳輸差異的簡(jiǎn)單方法。

創(chuàng )建一個(gè) Git 倉庫的復刻。在這個(gè)例子中，假設你的復刻位于 example.com/<USER>/pbench。

2、接下來(lái)，你必須獲得一個(gè)統一資源標識符 （URI），以便通過(guò) SSH 進(jìn)行克隆cloning。在大多數 Git 托管服務(wù)上，比如 GitLab 或 GitHub，它在一個(gè)標有 “Clone” 或 “Clone over SSH” 的按鈕或面板上，可以將克隆 URI 復制到剪貼板中。

3、在你的開(kāi)發(fā)系統中，使用你復制的 URI 克隆倉庫：

$ git clone git@example.com:<USER>/pbench.git

這將以默認名稱(chēng) origin 來(lái)克隆 Git 倉庫，作為你的 pbench 倉庫復刻副本。

4、切換到剛才克隆的目錄：

$ cd ~/pbench

5、下一步，獲取源倉庫的 SSH URI（你最初復刻的那個(gè)）。這可能和上面的方法一樣。找到 “Clone” 按鈕或面板，復制克隆地址。在軟件開(kāi)發(fā)中，這通常被稱(chēng)為“上游”，因為（理論上）這是大多數提交發(fā)生的地方，而你打算讓這些提交流向下游的倉庫。

6、將 URI 添加到你的本地倉庫中。是的，將有兩個(gè)不同的遠程倉庫分配給你的本地倉庫副本：

$ git remote add upstream git@example.com:bigproject/pbench.git

7、現在你有兩個(gè)命名遠程倉庫：origin 和 upstream。 你可以用 remote 子命令查看你的遠程倉庫：

$ git remote -v

現在，你的本地 master 分支正在跟蹤 origin 的 master，這不一定是你想要的。你可能想跟蹤這個(gè)分支的 upstream 版本，因為大多數開(kāi)發(fā)都在上游進(jìn)行。這個(gè)想法是，你要在從上游獲得的內容的基礎上添加更改。

8、將你的本地的 master 分支改成跟蹤 upstream/master：

$ git fetch upstream

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

你可以對任何你想要的分支這樣做，而不僅僅是 master。例如，有些項目使用 dev 分支來(lái)處理所有不穩定的變化，而將 master 保留給已批準發(fā)布的代碼。

9、一旦你設置了你的跟蹤分支，一定要變基（rebase）你的 master 分支，使它與上游倉庫的任何新變化保持一致：

$ git remote update

$ git checkout master

$ git rebase

這是一個(gè)保持 Git 倉庫在不同復刻之間同步的好方法。如果你想自動(dòng)完成這項工作，請閱讀 Seth Kenlon 關(guān)于使用 Ansible 托管 Git 倉庫的文章。