[[357214]]

擁有一致的命名標(biāo)準(zhǔn)是保持本地和上游 Git 倉(cāng)庫保持一致的關(guān)鍵。

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

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

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

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

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

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

3、在你的開發(fā)系統(tǒng)中，使用你復(fù)制的 URI 克隆倉(cāng)庫：

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

這將以默認(rèn)名稱 origin 來克隆 Git 倉(cāng)庫，作為你的 pbench 倉(cāng)庫復(fù)刻副本。

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

$ cd ~/pbench

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

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

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

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

$ git remote -v

現(xiàn)在，你的本地 master 分支正在跟蹤 origin 的 master，這不一定是你想要的。你可能想跟蹤這個(gè)分支的 upstream 版本，因?yàn)榇蠖鄶?shù)開發(fā)都在上游進(jìn)行。這個(gè)想法是，你要在從上游獲得的內(nèi)容的基礎(chǔ)上添加更改。

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

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

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

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

$ git remote update
$ git checkout master
$ git rebase

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