Github代碼Fork之后，如何與原倉庫進行同步？
本文轉載自微信公眾號「程序新視界」，作者二師兄。轉載本文請聯系程序新視界公眾號。
前言
我們在使用GitHub時，看到好的項目或想給某個項目做貢獻，此時通常會將代碼倉庫fork到自己的賬號下。如果在此期間，如果源倉庫的代碼發生了變動，就需要與源倉庫代碼進行同步。本篇文章就帶大家實操一下，如何實現這一操作。
配置項目的上游倉庫
首先需要大家將fork的倉庫代碼clone到本地，后面的所有操作都是基于本地代碼庫來進行操作的。比如，可以通過git clone先將fork的代碼下載到本地：
- git clone git@github.com: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中可視化的插件進行代碼沖突解決，你也可以選擇你喜歡的方式進行解決。
解決完沖突之后，就可以執行正常的代碼add、commit和push操作了。這里的一系列操作都是針對自己fork的倉庫的，對應操作實例如下：
- 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
上述操作，通過add、commit、push一系列操作，將源倉庫中的修改內容，提交到自己fork的分支當中了。此時再查看自己fork的GitHub倉庫，發現代碼已經更新。
小結
本篇文章介紹了當我們fork一個倉庫代碼之后，如何將上游倉庫最新的代碼與自己倉庫進行同步更新。如果你喜歡fork一些優秀的代碼，需要在GitHub上為開源項目做貢獻，那么這個基本的操作必須得了解一下。
