GitHub学习记录8

Github/Gitee使用说明

使用Github托管代码

创建仓库

一个GitHub仓库实质上是一个包含了你的项目所有文件的文件夹。

.git文件夹也包含在其中，用于版本控制。

登陆GitHub主页，点击右上角+号即可创建一个仓库，如下图：

点击后会跳转到新建仓库的表单：

注意：

  1. github上的仓库一般都会包含readme文件，该readme文件会在项目页面进行展示
  2. .gitignore文件可以用来忽略工作区的私有文件（例如本地配置、缓存文件、node_modules等）

点击绿色的code按钮，选择相应的协议即可拿到该项目的地址，在本地只需要clone下来就可以进行开发了，开发完成后push到原仓库即可

仓库界面介绍

以学长的计算机图形学作业仓库为例：

页面的左上角：

Star：Star类似于朋友圈的点赞，给项目star代表了你对项目的认可

所以尽量不要像朋友圈集赞一样要求身边朋友刷star

Fork：Fork操作实际上是创建一个仓库的副本，并将仓库的upstream指向原仓库

小问题：为什么要fork呢？为什么不直接push呢？

fork方便了多人协作

Watch：Watch操作可以向你的邮箱中推送该仓库的推送信息

提示：如果不是特别重要的项目，不要随意点Watch，否则很容易邮箱被轰炸

Issues: Issues在Github官方文档中被翻译为议题，作用是针对仓库的内容进行讨论（例如bug反馈/新功能推荐）

提示：Issues不等同于评论区，Issues板块应该专注于解决问题，不要在Issues中发一些和项目无关的内容，这样可能会消耗很多maintainer的精力

Pull Requests：Pull Requests，简称PR，是github中将修改过的代码分支合并到目标分支的操作。前面git的学习中，我们都知道commit是git的最小工作单元，在github的仓库中，PR是主要的工作单元。很多同学刚刚接触GitHub时，对于Pull Requests很不理解：什么是拉取请求？在gitlab中，pr的操作叫做Merge Request， 实际上大家可以把PR理解为“我修改好了你的代码，现在请求你把代码拉回主仓库中”

Action：Github Action 是GitHub推出的自动化构建工具，感兴趣的同学可以阅读文档

Projects：针对某一仓库的项目板（看板）

Wiki： 存放一些介绍性的内容

Security：与安全相关，这里不做介绍

Insight：里面包含里项目的一些数据，包括代码贡献的时间分布图，每个人的贡献量等metric

提交Issue

提交PR

如果你fork了一份项目代码并做了修改，并且希望将修改的代码合并进上游仓库中，就可以提交PR。

注意：不是所有的PR都会被合并，所以在提交PR前请先和maintainer进行沟通，并且在开发的过程中反馈进度，一种比较好的方式就是draft PR。

draft PR表示该PR还没有开发完，项目的maintainer不需要进行reveiw和merge，只需要简单看看代码是否符合预期。

小提示：在提交PR时，尽可能关联相关Issue，并说明你的代码解决了什么问题。