如何在GitHub上更新Fork以及PullRequest给源项目

本文作者黄昱俊，国资企业投资部总经理，主要负责投资部门建设、投资流程管理、投后资源管理。历经10年，从医疗器械研发工程师到投资管理的蜕变，业余尝试ETF量化投资。

本文介绍如何在GitHub上更新Fork以及PullRequest给源项目。

在GitHub上更新Fork

经常遇到的是Fork一个项目之后，源项目的作者做了新的更改，如果没有同步到我自己的Fork，我所做的更新进行Pull Request后，会产生冲突；因此在更新文件之前、至少是Pull Request之前，应当要更新自己的Fork的。

更新Fork的方法有很多，Git写代码是很好的，当小白通常比较难做，步骤缺了就经常不奏效；所以我自己亲测了一个GitHub上更新Fork的方法，做一个教程，与朋友们共勉；废话少说，步骤如下。

一、进入自己Fork来的项目，按New Pull Request按钮，新建一个Pull Request（简称：PR）。

二、如果自己还没有修改过Fork项目的文件，那么此时可以点击switching the base，切换到基于我自己的Fork项目。

如果已经修改或更新过Fork项目的文件，那么可以通过选择Base Fork和Head Fork来从源项目更新到我自己的Fork项目。

这里有个小技巧：在默认状态下，会是Base源项目，Head我自己的Fork项目；这样选择任何一个时，会调到某个无法更新的页面；解决方法是先Base或Head一个其他人的账号下的Fork，接着选择Head/Base源项目或我自己的Fork项目，这样就不会出现Base和Head都是自己或者都是源项目的情况。

三、Base和Head设置完，就进入Comparing Changes页面，确认一下Base和Head，以及最新的更新内容。

内容没问题就Create PR了，即上图绿色箭头所指向的绿色按钮；接着输入主题，Create。

四、新Create的PR在哪里可以找到呢？进入我自己的Fork项目，导航条上的PR进入，看到Open的有一个，就是刚才更新的。

点击进入确认一下。

五、把源项目的更新Merge到我的Fork项目。

Confirm Merge，确定这个更新；

可以看到，这个PR已经更新完成，呈紫色的Merge状态。

六、最后验证一下是否更新到最新的项目，因为已知是更新了Pattern Recognition，所以直接进入。

查看到下面5个是最新修改的，15个小时之前修改了内容。

至此整个更新Fork的方法步骤已完成，玩得愉快！

将更新的Fork项目PullRequest给源项目

我们Fork项目之后进行了修改或添加新文件，需要Pull Request（简称：PR）给源项目，让作者Merge融入到他的源项目里。

在PR之前，甚至开始修改或创建新文件之前，先看看源项目是否有更新，如有更新，可按第一部分内容，先更新自己的Fork项目，再做创建新文件，老司机说这样冲突比较少。

一、看到别人的好项目，如何“据为己有”？Fork一下咯！

点击Fork，会进入Fork进行中的界面；

Fork完成后，可以在自己的主页（Your Profile）看到Fork的项目。

二、可以通过Create new file或upload file新建或上传文件，要注意的是：上传的文件会把原来同名文件覆盖掉！

这里的会有文件上传的进度条，如下图：共13个文件，已上传9个；上传完成的文件会在下方显示。

这个上传文件由于服务器在国外的缘故，死慢死慢，经常就废了，如下图。

当看到下面这个Processing your files…页面，那就恭喜你了，经过几十次的上传，总算work了；如果出现一片空白的页面，那么只好重复choose your files，再次Confirm Changes。

三、新建PR：可以在Fork项目的根目录下，或者任意的目录下，Pull Request。

Pull Request后会进入Comparing changes页面，核对一下Base Fork和Head Fork（蓝色圆圈）、以及更新的内容（紫色方框）；由于已经更新过最新的源项目内容，与源项目同步好了，所以此时显示“Able to merge”（红圈绿字）；一切就绪，点击Create创建PR。

输入主题，并Create PR；

这时可以看到已经将这个更新PR给源项目作者，PR序号为#52，状态open。

四、源项目作者Merge此PR，将此次的更改融入到源项目，并形成Commits记录。

序号#52的PR已经Merge：

进入源项目，查看Commit记录：

至此，整个Fork、修改或创建文件、Pull Request以及Merge的步骤已完成，玩的愉快！