[[357214]]

擁有一致的命名標準是保持本地和上游 Git 倉庫保持一致的關鍵。

當本地 Git 倉庫的命名與遠程倉庫不一致時，與遠程倉庫協作就會變得很混亂。

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

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

1、在大多數 Git 托管服務上，當你想在上面工作時，必須對它進行復刻。當你運行自己的 Git 服務器時，這并不是必要的，但對于一個公開的代碼庫來說，這是一個在貢獻者之間傳輸差異的簡單方法。

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

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

3、在你的開發系統中，使用你復制的 URI 克隆倉庫：

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

這將以默認名稱 origin 來克隆 Git 倉庫，作為你的 pbench 倉庫復刻副本。

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

$ cd ~/pbench

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

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

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

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

$ git remote -v

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

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

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

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

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

$ git remote update
$ git checkout master
$ git rebase

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