Github代碼fork之後，如何與原倉庫進行同步？

前言

我們在使用GitHub時，看到好的項目或想給某個項目做貢獻，此時通常會将代碼倉庫fork到自己的賬号下。如果在此期間，如果源倉庫的代碼發生了變動，就需要與源倉庫代碼進行同步。本篇文章就帶大家實操一下，如何實作這一操作。

配置項目的上遊倉庫

首先需要大家将fork的倉庫代碼clone到本地，後面的所有操作都是基于本地代碼庫來進行操作的。比如，可以通過git clone先将fork的代碼下載下傳到本地：

git clone [email protected]:secbr/nacos.git
           

後續的一步步操作，都是基于本地倉庫來進行操作。

進入到本地倉庫目錄

通過cd操作，進入到clone下來的本地倉庫根目錄：

cd /Users/apple/develop/nacos-request/nacos
           

後續的操作無特殊說明，都是在這個本地倉庫的目錄下進行操作。

檢視遠端倉庫路徑

執行指令 git remote -v 檢視遠端倉庫的路徑：

appledeMacBook-Pro-2:nacos apple$ git remote -v
origin  https://github.com/secbr/nacos.git (fetch)
origin  https://github.com/secbr/nacos.git (push)
           

如果隻顯示2行内容，說明該項目還未設定upstream（中文叫：上遊代碼庫），一般情況下，設定好一次upstream後就無需重複設定。通過顯示遠端倉庫的路徑和clone時的路徑對照，會發現，此時遠端倉庫的路徑還是fork項目的路徑。

添加upstream路徑

執行指令 git remote add upstream https://xxx.git，把fork的源倉庫設定為 upstream 。這裡項目是從alibaba的nacos倉庫fork過來的，是以對應的upstream就是alibaba的源倉庫位址。

執行上述指令，在此執行git remote -v 檢查是否成功。

appledeMacBook-Pro-2:nacos apple$ git remote add upstream https://github.com/alibaba/nacos.git
appledeMacBook-Pro-2:nacos apple$ git remote -v
origin  https://github.com/secbr/nacos.git (fetch)
origin  https://github.com/secbr/nacos.git (push)
upstream        https://github.com/alibaba/nacos.git (fetch)
upstream        https://github.com/alibaba/nacos.git (push)
           

通過上面的輸出可以看出，多了兩項upstream的位址，說明添加upstream成功。

檢查本地代碼狀态

由于我們的執行個體是直接從倉庫clone下來的，本地還沒有修改代碼。如果你的本地項目已經修改了一些代碼，不确定是否送出了代碼，就需要執行git status來檢查一下。

appledeMacBook-Pro-2:nacos apple$ git status
On branch develop
Your branch is up to date with 'origin/develop'.

nothing to commit, working tree clean
           

上面顯示，本地沒有需要送出的（commit）的代碼。如果本地有修改，需要先從本地倉庫推送到GitHub倉庫。然後，再執行一次 git status 檢查。

對應推送到GitHub倉庫的基本操作步驟如下：

git add -A 或者 git add filename
git commit -m "your note"
git push origin master
git status
           

完成上面的基本操作之後，确認代碼都已經送出，便可以開始執行源倉庫與本地倉庫的merge操作了。

抓取源倉庫的更新

經過上面步驟的準備之後，我們可以進行源倉庫的代碼更新了。執行指令 git fetch upstream 抓取原倉庫的更新：

appledeMacBook-Pro-2:nacos apple$ git fetch upstream
remote: Enumerating objects: 2646, done.
remote: Counting objects: 100% (2593/2593), done.
remote: Compressing objects: 100% (1157/1157), done.
remote: Total 2646 (delta 731), reused 2404 (delta 682), pack-reused 53
Receiving objects: 100% (2646/2646), 1.67 MiB | 1.47 MiB/s, done.
Resolving deltas: 100% (734/734), completed with 37 local objects.
From https://github.com/alibaba/nacos
 * [new branch]          0.2.1                               -> upstream/0.2.1
 * [new branch]          0.2.2                               -> upstream/0.2.2
 * [new branch]          0.3.0                               -> upstream/0.3.0
//...省略一部分
           

執行上述指令之後，上遊倉庫的更新（commit）會本存儲為本地的分支，通常名稱為：upstream/BRANCHNAME。比如上面的upstream/0.3.0。

切換分支

完成了上遊倉庫分支的拉取之後，先來核查一下本地倉庫目前處于哪個分支，也就是需要更新合并的分支。比如，這裡我需要将develop分支的内容更新到與上遊倉庫代碼一緻。則先切換到develop分支：

appledeMacBook-Pro-2:nacos apple$ git checkout develop
Already on 'develop'
Your branch is up to date with 'origin/develop'.
           

上面提示已經是develop分支了。

執行合并

執行指令 git merge upstream/develop 合并遠端的develop分支。比如你合并的可能是master，可根據需要将develop的名稱替換成對應的master。

appledeMacBook-Pro-2:nacos apple$ git merge upstream/develop
Removing test/src/test/java/com/alibaba/nacos/test/naming/DeregisterInstance_ITCase.java
// ...省略一部分
Removing naming/src/test/java/com/alibaba/nacos/naming/core/PushServiceTest.java
Auto-merging client/src/main/java/com/alibaba/nacos/client/naming/remote/http/NamingHttpClientProxy.java
CONFLICT (content): Merge conflict in client/src/main/java/com/alibaba/nacos/client/naming/remote/http/NamingHttpClientProxy.java
Removing client/src/main/java/com/alibaba/nacos/client/naming/core/HostReactor.java
Removing .editorconfig
Automatic merge failed; fix conflicts and then commit the result.
           

執行完上述指令之後，會發現上遊代碼指定分支的修改内容已經反映到本地代碼了。

上傳代碼到fork分支

執行完上一步的合并操作之後，往後還有一些後續處理，比如代碼沖突。如果本地修改了内容，上遊倉庫也修改了對應的代碼，則可能會出現沖突。這時就需要對比代碼進行修改。本人更習慣使用IDEA中可視化的插件進行代碼沖突解決，你也可以選擇你喜歡的方式進行解決。

appledeMacBook-Pro-2:nacos apple$ git add .
appledeMacBook-Pro-2:nacos apple$ git commit -m 'merge from nacos'
[develop 8601c1791] merge from nacos 
appledeMacBook-Pro-2:nacos apple$ git push
Enumerating objects: 4, done.
Counting objects: 100% (4/4), done.
Delta compression using up to 12 threads
Compressing objects: 100% (2/2), done.
Writing objects: 100% (2/2), 281 bytes | 281.00 KiB/s, done.
Total 2 (delta 1), reused 0 (delta 0), pack-reused 0
remote: Resolving deltas: 100% (1/1), completed with 1 local object.
To https://github.com/secbr/nacos.git
   76a4dcbb1..8601c1791  develop -> develop
           

小結