Github Fork 过程概述

在 Github 上有很多优秀的开源项目，相信每一位热衷于技术的朋友都会在 Github 上 Fork 一些感兴趣的项目，然后在本地修改并提交。本文以 Galaxy Project 下的 galaxy 仓库为例，在 Github 上 Fork 该项目，更新提交的一个完整过程如下图所示：

image.png

  1. fork 一个项目，比如 galaxy，该操作会复制该项目的所有历史提交内容到个人仓库中，并生成一个相同的项目；
  2. clone 之前 fork 的项目到本地计算机中；
  3. 在本地仓库中更新某些文件；
  4. 提交更新的文件到本地仓库；
  5. 将本地仓库的更改内容推送 push 到个人 github 远程仓库；
  6. 创建 pull 请求，既可以把 fork 原始项目中别人的更新同步到自己的 github 仓库中，也可以提交个人更新的内容到 fork 的原始项目。

我 fork 的 galaxyproject/galaxy 项目如下：
1-shen-galaxy-master.png

galaxyproject/galaxy 项目 master 版本最新进展如下，可以看到已经有了很大新的代码提交：
2-galaxyproject-master.png

下面我们简单介绍一下，如何同被 fork 的项目保持同步更新，将以 galaxyproject/galaxy 项目为例。

fork 同步更新步骤

  1. 打开自己的 github 中 fork 的项目，打开 Code 选项卡，点击下面的 “New pull request” 创建一个新的 pull 请求；

3-new-pull-request.png

  1. 在 Comparing chanages 页面，如下图所示，这时 base fork 默认是你 fork 的项目，而 head fork 则默认是你自己的仓库。

5-compare-change.png

  1. 在上图中进行选择（前面的 base-fork 选择自己的 github 仓库）后会出现如下图所示页面，这时需要点击 “compare across forks”，再一次进行选择。

5.1-compare-fork.png

  1. 具体选择如下：base:master 是自己仓库和分支，后面选择 head fork, compare:master 是你 fork 项目来源的仓库和分支，可以对比两个项目前后的变化情况。然后点击 “Create pull request”，创建新的 pull 请求。

compare-change.png

  1. 填写标题（Title）和评论（Comment），并点击 Create pull request。Preview 可以预览评论效果，右侧有 5 个选项可以设置检阅用户（Reviewers）、分配给哪个用户（Assignees）、Labels 标签（bug、duplocate、enhancement、help wanted、invalid、question、wontfix，也支持自定义）、项目（Projects），以及里程碑事件（Milestone）。

pull-request-commit.png

  1. 点击 “Create pull request” 之后，就可以在 Pull request 中看到刚才提交的 comment，如下所示。

update-master.png

  1. 可以看到期间有很多的提交更新，往下翻可以找到如下图所示，点击 “Merge pull request”。

6-merge-master-pull-request.png

  1. 填写 Merge 的评论并且提交，如果有冲突一定要先解决冲突，然后就全部 OK 了。

7-confirm-merge.png

  1. 最后，再次打开自己仓库的 galaxy 项目，可以看到项目已更新到最新版本，和最开始 galaxy 原始项目内容一致了。

8-galaxy-master-fork.png

2-galaxyproject-master.png

总结

本文讲解了同步更新 Github 上 Fork 项目的其中一种方法，还有其他的方法比如可以删除个人 github 中 fork 的该项目然后重新 fork，这种方式不能合并自己已更新的代码；还有另外一种方式是在本地建立两个仓库，把两个远程库都 clone 到本地，然后拉取原 fork 项目更新到本地，合并更新，最后 push 到你个人的 github 即可。