Github代码Fork之后，如何与原仓库进行同步？

也想出现在这里？点击联系我~

前言

我们在使用GitHub时，看到好的项目或想给某个项目做贡献，此时通常会将代码仓库fork到自己的账号下。如果在此期间，如果源仓库的代码发生了变动，就需要与源仓库代码进行同步。本篇文章就带大家实操一下，如何实现这一操作。

配置项目的上游仓库

首先需要大家将fork的仓库代码clone到本地，后面的所有操作都是基于本地代码库来进行操作的。比如，可以通过git clone先将fork的代码下载到本地：

1. gitclonegit@github.com:secbr/nacos.git

后续的一步步操作，都是基于本地仓库来进行操作。

进入到本地仓库目录

通过cd操作，进入到clone下来的本地仓库根目录：

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

后续的操作无特殊说明，都是在这个本地仓库的目录下进行操作。

查看远程仓库路径

执行命令 git remote -v 查看远程仓库的路径：

1. appledeMacBook-Pro-2:nacosapple$gitremote-v
2. originhttps://github.com/secbr/nacos.git(fetch)
3. originhttps://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 检查是否成功。

1. appledeMacBook-Pro-2:nacosapple$gitremoteaddupstreamhttps://github.com/alibaba/nacos.git
2. appledeMacBook-Pro-2:nacosapple$gitremote-v
3. originhttps://github.com/secbr/nacos.git(fetch)
4. originhttps://github.com/secbr/nacos.git(push)
5. upstreamhttps://github.com/alibaba/nacos.git(fetch)
6. upstreamhttps://github.com/alibaba/nacos.git(push)

通过上面的输出可以看出，多了两项upstream的地址，说明添加upstream成功。

检查本地代码状态

由于我们的实例是直接从仓库clone下来的，本地还没有修改代码。如果你的本地项目已经修改了一些代码，不确定是否提交了代码，就需要执行git status来检查一下。

1. appledeMacBook-Pro-2:nacosapple$gitstatus
2. Onbranchdevelop
3. Yourbranchisuptodatewith'origin/develop'.
5. nothingtocommit,workingtreeclean

上面显示，本地没有需要提交的(commit)的代码。如果本地有修改，需要先从本地仓库推送到GitHub仓库。然后，再执行一次 git status 检查。

对应推送到GitHub仓库的基本操作步骤如下：

1. gitadd-A或者gitaddfilename
2. gitcommit-m"yournote"
3. gitpushoriginmaster
4. gitstatus

完成上面的基本操作之后，确认代码都已经提交，便可以开始执行源仓库与本地仓库的merge操作了。

抓取源仓库的更新

经过上面步骤的准备之后，我们可以进行源仓库的代码更新了。执行命令 git fetch upstream 抓取原仓库的更新：

1. appledeMacBook-Pro-2:nacosapple$gitfetchupstream
2. remote:Enumeratingobjects:2646,done.
3. remote:Countingobjects:100%(2593/2593),done.
4. remote:Compressingobjects:100%(1157/1157),done.
5. remote:Total2646(delta731),reused2404(delta682),pack-reused53
6. Receivingobjects:100%(2646/2646),1.67MiB|1.47MiB/s,done.
7. Resolvingdeltas:100%(734/734),completedwith37localobjects.
8. Fromhttps://github.com/alibaba/nacos
9. *[newbranch]0.2.1->upstream/0.2.1
10. *[newbranch]0.2.2->upstream/0.2.2
11. *[newbranch]0.3.0->upstream/0.3.0
12. //…省略一部分

执行上述命令之后，上游仓库的更新(commit)会本存储为本地的分支，通常名称为：upstream/BRANCHNAME。比如上面的upstream/0.3.0。

切换分支

完成了上游仓库分支的拉取之后，先来核查一下本地仓库当前处于哪个分支，也就是需要更新合并的分支。比如，这里我需要将develop分支的内容更新到与上游仓库代码一致。则先切换到develop分支：

1. appledeMacBook-Pro-2:nacosapple$gitcheckoutdevelop
2. Alreadyon'develop'
3. Yourbranchisuptodatewith'origin/develop'.

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

执行合并

执行命令 git merge upstream/develop 合并远程的develop分支。比如你合并的可能是master，可根据需要将develop的名称替换成对应的master。

1. appledeMacBook-Pro-2:nacosapple$gitmergeupstream/develop
2. Removingtest/src/test/java/com/alibaba/nacos/test/naming/DeregisterInstance_ITCase.java
3. //…省略一部分
4. Removingnaming/src/test/java/com/alibaba/nacos/naming/core/PushServiceTest.java
5. Auto-mergingclient/src/main/java/com/alibaba/nacos/client/naming/remote/http/NamingHttpClientProxy.java
6. CONFLICT(content):Mergeconflictinclient/src/main/java/com/alibaba/nacos/client/naming/remote/http/NamingHttpClientProxy.java
7. Removingclient/src/main/java/com/alibaba/nacos/client/naming/core/HostReactor.java
8. Removing.editorconfig
9. Automaticmergefailed;fixconflictsandthencommittheresult.

执行完上述命令之后，会发现上游代码指定分支的修改内容已经反映到本地代码了。

上传代码到fork分支

执行完上一步的合并操作之后，往后还有一些后续处理，比如代码冲突。如果本地修改了内容，上游仓库也修改了对应的代码，则可能会出现冲突。这时就需要对比代码进行修改。本人更习惯使用IDEA中可视化的插件进行代码冲突解决，你也可以选择你喜欢的方式进行解决。

解决完冲突之后，就可以执行正常的代码add、commit和push操作了。这里的一系列操作都是针对自己fork的仓库的，对应操作实例如下：

1. appledeMacBook-Pro-2:nacosapple$gitadd.
2. appledeMacBook-Pro-2:nacosapple$gitcommit-m'mergefromnacos'
3. [develop8601c1791]mergefromnacos
4. appledeMacBook-Pro-2:nacosapple$gitpush
5. Enumeratingobjects:4,done.
6. Countingobjects:100%(4/4),done.
7. Deltacompressionusingupto12threads
8. Compressingobjects:100%(2/2),done.
9. Writingobjects:100%(2/2),281bytes|281.00KiB/s,done.
10. Total2(delta1),reused0(delta0),pack-reused0
11. remote:Resolvingdeltas:100%(1/1),completedwith1localobject.
12. Tohttps://github.com/secbr/nacos.git
13. 76a4dcbb1..8601c1791develop->develop

上述操作，通过add、commit、push一系列操作，将源仓库中的修改内容，提交到自己fork的分支当中了。此时再查看自己fork的GitHub仓库，发现代码已经更新。

小结

本篇文章介绍了当我们fork一个仓库代码之后，如何将上游仓库最新的代码与自己仓库进行同步更新。如果你喜欢fork一些优秀的代码，需要在GitHub上为开源项目做贡献，那么这个基本的操作必须得了解一下。

原文链接：https://mp.weixin.qq.com/s/-6jQ0I81rS9FFsdHSEGt1Q