06.md · 楼韵佳/蒋老师的码云使用教程

## 六、通过 Fork 参与项目完善
------

### 1. 什么是 Fork ？

Fork 英文原意是 **叉子**<a href="https://fanyi.baidu.com/?aldtype=85#en/zh/Fork" target="_blank"> 单击此处 </a> Scratch2 打开相应的百度翻译网页，可以音译为 **复刻** ，在 Git 中可以意译为 **分叉** 。

除了 Fork ，我们下文还会使用到一个 Git 术语： Pull Requests ，在这里 pull 是动词 **拉、拖** 的意思， requests 是名词 **需要、请求** 的意思；因此在 Git 中可以意译为： **请求合并** 。

在码云网站中，可以通过 Fork 将别人的项目复制到自己的账号上来；然后对复制的项目内容进行修订————修改别人项目文件中的错误、优化别人项目中的内容；完成这些修订内容并确认正确后，向项目拥有者提交 Pull Requests ，请求将自己的修订内容合并原有的项目中去；项目拥有者根据提交的 Pull Requests ，决定是否合并提交的修订内容到项目中去。

由于本文目标读者不是专业程序员，因此以上流程不是通过输入各种 Git 代码完成的，而是直接通过码云网站的网页参与项目的完善。

### 2. Fork 指定项目仓库

要参与项目的完善，首先需要按照前面文章的方法，搜索并打开这个项目网页，如下图所示就是本文接下来要 Fork 的 **项目网页** ：

(1) 请注意 **项目网页** 的左上角，目前是这个项目创建者（组织）的账号名以及这个项目的名称，后期在 Fork 、 Pull Requests 的时候务必要清楚当前项目到底是自己账号下的，还是创建者账号下的。

(2) 确认要 Fork 打开这个项目，只要单击 **项目网页** 右上角的 **Fork** 按钮，就会打开如下图所示的网页：

* 在 **Fork仓库** 网页中，首先单击选中 Fork 到哪里，一般就是网页中间显示的自己账号头像。

* 最后单击 **确认** 按钮。

选择完 Fork仓库 以后，网站会提示：**当前仓库正在后台处理中，完成后将自动刷新页面** 。

如果项目文件不多的话，稍等片刻就会显示如下图所示 Fork 完成后的 **项目网页** ：

同样请注意观察 Fork 完成后的这个 **项目网页** 的左上角：

* 显示的是当前登录用户的账号（也就是你自己的账号），而不是原来项目创建者的账号名；账号左边的图标也变成了类似 **叉子** 样的，表明这个项目是 Fork 得到的。

* 项目名称 Fork 完成后没有变化。

* 右上角 **Fork** 按钮右边的数字在原来的基础上增加了 **1** ，单击这个数字可以在新打开的网页中查看 Fork 这个项目用户的列表。

### 3. 修改、完善 Fork 项目仓库中的文件

Fork 指定项目仓库与在计算机上复制文件夹类似，也是得到了一个与原始项目完全相同的项目仓库副本，无非这个仓库是保存在码云网站自己账号空间里的。

对于 Fork 的项目仓库文件，可以根据自己意愿，在默认显示的 **项目** 网页的 **代码** 选项卡中（如下图所示），随意添加、删除文件，修改文件内容，也就是说拥有完全的管理权限：

* 单击 **文件** 按钮，在下拉列表菜单中可以 **新建文件** 、 **新建文件夹** ，还可以 **上传文件** ，将本地文件上传到项目仓库中。

* 右键单击列表区的文件名，可以打开该文件的 **右键菜单** ，对这个文件进行 **删除** 、 **重命名** 、 **复制** 或者在 **新标签打开** （也就是在新的浏览器标签页中显示这个文件内容）。

* 左键单击列表区的文件名，则会显示这个文件的内容。在 [第四章 如何下载项目资源？](04.md) 中已有详细介绍，需要特别说明的是，如果打开的是文本格式的文件（比如扩展名为 .md 的 Markdown 文件），可以在 **预览区域** 右上角的菜单栏中找到 **编辑** 按钮（如下图所示），单击这个按钮会进入码云网站提供的 Markdown 编辑器窗口，对文件的文本内容进行编辑（关于码云网站 Markdown 编辑器的使用方法将在后面章节详细介绍）。

### 4. 通过 Pull Requests 提交合并请求

通过以上步骤，修改的只是自己帐号下的项目仓库文件，而不是原始项目的仓库。也就是说，如果你没有原始项目的相应权限，是不能直接修改原始项目仓库文件的。

如果要将自己修改的文件上传到原始项目仓库，参与项目完善工作，在 Git 术语中称之为 **提交合并请求** ，需要通过 Pull Requests 进行操作，具体可以按以下步骤操作：

(1) 确保已经对 Fork 的项目仓库文件做了必要的修改，并且确认没有错误。

(2) 单击 **项目** 网页的 **Pull Requests** 选项卡，打开如下图所示的 **Pull Requests** 选项卡网页，然后单击右上角的 **新建 Pull Requests** 按钮，在选项卡下方显示 **创建 Pull Requests** 网页。

(3) 在如下图所示的 **创建 Pull Requests** 网页中：

* 最上面是 **源分支** 和 **目标分支** ；前者是你自己修改过的项目仓库默认分支，一般默认是 **master** ，后者是你想合并的项目仓库默认分支，是由项目管理员设置的；具体的分支都可以在下拉列表中选择。

* 在 **创建 Pull Requests** 标签文字右边是网站对这次合并的评估；如果是绿色的 **可自动合并** ，说明要提交的合并内容与项目仓库文件没有冲突，网站可以通过网页方式自动合并；如果不可以自动合并，那就需要使用 Git 命令行方式手工合并，具体的操作方式由于比较复杂，将另行撰写文章介绍。

* 如果是 **可自动合并** 状态，可以在下方的文本框内输入这次合并的标题；在文本编辑区域输入对这次合并的详细说明；一般需要说明本次请求合并的文件与原仓库文件有什么区别？为什么要请求合并？

* 如果有必要，还可以在网页右边的 **协作选项** 区域选择需要的协作选项。

* 最后单击右下角的 **创建** 按钮，提交本次合并请求，会自动打开这个 Pull Requests 的详细内容网页。

(4) 在如下图所示自动打开的 **Pull Requests 内容** 网页中：

* 最上方是这个 Pull Requests 的基本信息。包括左边第一行的 Pull Requests 当前状态、自动编号和标题，第二行的 Pull Requests 分支信息，第三行的 Pull Requests 创建帐号及创建时间，以及最后一行的 Pull Requests 内容说明；右上角是四个工具按钮，可以对这个 Pull Requests 进行相应的操作。

* 中间是这个 Pull Requests 的互动信息，可以详细了解 Pull Requests 提交及后续的讨论、交流过程。

* 最下方有三个子选项卡，在 **评论** 子选项中可以提交对当前 Pull Requests 的讨论交流信息，在 **提交** 子选项卡中可以查看这个项目所有提交的合并请求，在 **文件** 子选项卡中可以查看所有发生了变化的项目文件。

> 在 以上第 3 步创建 Pull Requests 网页及第 4 步 Pull Requests 内容网页中，如果注意观察 **项目网页** 左上角的项目账号名称的话，可以发现显示的都是原始项目拥有者的帐号。这说明以上这两步操作都是在原始项目网页中进行的操作，而不是在自己帐号项目里操作。

### 5. 等待项目拥有者同意合并

合并请求提交以后，是否同意合并是由项目拥有者决定的。

项目拥有者会接收到网站自动发送给他的 **通知** ，在他进入到如上图所示的 **Pull Requests 内容** 网页时，可以详细查看、审核 Pull Requests ，决定是否将提交的修订合并到项目仓库中去，还是需要做进一步的交流、讨论，或者干脆关闭这个 Pull Requests ，不合并提交的文件。

不管项目拥有者如何处理提交的 Pull Requests ，作为这个 Pull Requests 的提交者，都会通过网站的 **通知** 功能，第一时间收到相应的通知信息。当然也可以随时点击原始项目网页的 **Pull Requests** 选项卡，查看所提交 Pull Requests 的状态（如下图所示）。

> 请特别注意：必须要进入原始项目仓库查看，而不是自己账号下的项目仓库。

### 相关链接

* [目录](readme.md)
* 下一章: [七、为项目编写文本文档](07.md)
* 上一章: [五、通过 Issue 交流](05.md)

楼韵佳/蒋老师的码云使用教程

简介

发行版

贡献者

近期动态

楼韵佳/蒋老师的码云使用教程 .gitee-modal { width: 500px !important; }

简介

发行版

贡献者

近期动态

搜索帮助

楼韵佳/蒋老师的码云使用教程