Fork 一个示例仓库

Fork 是对一个仓库的克隆。克隆一个仓库允许你自由试验各种改变,而不影响原始的项目。

一般来说,forks 被用于去更改别人的项目(贡献代码给已经开源的项目)或者使用别人的项目作为你自己想法的初始开发点。


提出更改别人的项目

使用 forks 提出改变的一个很好的例子是漏洞修复。与其记录一个你发现的问题,不如:

  • Fork 这个仓库

  • 进行修复

  • 向这个项目的拥有者提交一个 pull requset


如果这个项目的拥有者认同你的成果,他们可能会将你的修复更新到原始的仓库中!


使用别人的项目作为你自己想法的初始开发点

许可文件,这个文件决定你是否希望将你的项目分享给其他人。

Fork 一个仓库分为简单的两步。我们已经创建了一个仓库让你用于练习!

  1. 在 GitHub 上,定位到octocat/Spoon-Knife仓库。

  2. 在页面右上角,点击 Fork 按钮。

github-click-fork.jpg

就这样!现在你已经 fork 这个原始的 octocat/Spoon-Knife 仓库。



同步你的 Fork 仓库

你或许已经 fork 一个项目为了提交更改向 upstream 或原始仓库。这种情况下,很好的实现了将 upstream 仓库定期同步到你的 fork。要做到这一点,你需要在命令行中使用 Git。你可以使用你刚刚 fork 的 octocat/Spoon-Knife 仓库去练习设置 upstream 仓库。

第一步:安装 Git

你首先应该 通过 Git 验证 GitHub

第二步:为你 fork 的仓库创建一个本地克隆

现在,你已经成功 fork Spoon-Knife 仓库,但在你自己的计算机上并没有这个仓库的文件。让我们克隆你 Fork 的代码到你本地的计算机上。

1、在 GitHub 上,定位到你 fork 的 Spoon-Knife 仓库。

2、在这个仓库页面的右侧边栏,点击复制图标复制这个仓库的 URL。

github-clone-repo-clone-url-button.png

3、打开 Terminal 命令(针对 Mac 用户)或提示命令行(Windows 和 Linux 用户)。

4、更改到你在步骤 2(创建一个本地)创建的你的 fork 的本地的目录。

  1. 回到根目录,只输入 cd

  2. 输入 ls,列出当前目录的文件和文件夹。

  3. 输入 cd 目录名”进入你输入的目录下。

  4. 输入 cd .. 回到上一目录。

5、输入 git remove -v,按下回车键,你将会看到你的 fork 当前配置的远程仓库:

$ git remote -v
origin https://github.com/YOUR_USERNAME/YOUR_FORK.git (fetch)
origin https://github.com/YOUR_USERNAME/YOUR_FORK.git (push)

6、输入 git remote add upstream,然后粘贴你在步骤 2 复制的 URL 并按下回车键。它看起来如下所示:

$ git remote add upstream https://github.com/octocat/Spoon-Knife.git

7、验证你 fork 里新指明的这个 upstream 仓库,再次输入 git remote -v。你将会看到你 fork 的 URL 作为原始的地址,而原始的仓库的 URL 作为 upstream。

$ git remote -v
origin  https://github.com/YOUR_USERNAME/YOUR_FORK.git (fetch)
origin  https://github.com/YOUR_USERNAME/YOUR_FORK.git (push)
upstream https://github.com/ORIGINAL_OWNER/ORIGINAL_REPOSITORY.git (fetch)
upstream https://github.com/ORIGINAL_OWNER/ORIGINAL_REPOSITORY.git (push)

现在,你可以保持你的 fork 与 upstream 的仓库的同步,利用几个 Git 命令。想知道更多信息,请参阅Syncing a fork