作者:秋秋

<aside> 🧭 如果你对 Git 尚不了解,请先去简单查看 Git 教程,对于我们的任务提交而言,只需要安装好 Git 并且知道最简单的推送代码操作即可。

</aside>

自己写的代码,一般都是开发者自己维护的仓库,拥有着诸多权限,可以让开发者随意更改。但是别人的开源项目,你并不会拥有直接更改的权限。所以在 Github 上提供了两个操作向开源项目贡献代码。

Fork

fork的定义是指的是将一个开源项目复制到自己的 GitHub 账户下的操作。当你 fork 一个项目时,你就拥有了该项目在你的 GitHub 账户下的一份完整拷贝,可以在此基础上进行修改、测试和实验等。需要说明的是,fork 并不是 Git 自带的功能,而是像 Github 这样的平台提供的协作功能。

PR

与fork相对的,当我们完成一些内容后,需要把我们的内容推送至开源项目中,但是我们并没有推送的权限,所以有了PR(Pull Request),Pull Request是指在GitHub或GitLab等代码托管平台上,开发者把自己修改后的代码提交给项目的管理者,请求他们审核并合并自己的代码的过程。

提交任务操作流程

  1. 首先 点击项目右上方的Fork按钮 将项目复制到自己的账户下
  2. 然后进入自己 fork 的项目中,通过 git clone下载到本地,按照任务要求将自己的任务内容放到指定的目录并推送。如果你正在使用 Vscode,这里推荐一个插件 git-commit-plugin 可以规范你的 commit 格式。
  3. 提交完成后回到我们fork 的项目中(指的是已经存在于自己仓库的复制体),点击Pull Request,因为是 fork 过来的项目,源分支(我们自己的 fork)和目标分支(主仓库) Github 会自动帮我们填好。我们只需要填一下PR的标题和描述即可。一般来讲,PR的标题应该简洁明了地概括你所做的修改。而PR的描述则是详细说明你的修改内容和目的,以便审核者更好地理解你的修改内容。需要注意的是,不能与目标仓库当前已有代码产生冲突噢。当我们创建了PR以后,就可以等待目标仓库的管理员审核通过啦~

最后,如果你有任何作业问题,欢迎在我们的学习群 or Discussions 里提出(作业示例代码可参考 GrayJiang 内文件)。