跳转至

GitHub的使用

GitHub的使用

更新日期:2021-01-17


1. 概述

作为全球最大的同性交友网站。 作为全球最大的开源代码分享网站。GitHub现在是开发者们最重要的交流平台。掌握这个工具平台的使用是非常有必要的。

2. 了解GitHub

我们在GitHub上能够做什么?

2.1 查看开源软件的信息

现在绝大部分开源软件的代码都托管在这个平台上。我们在使用需要的开源软件时,经常来这里进行下载。 该软件的源代码,文档,已知Bug,请求开发的功能也可以在这里找到。

2.2 参与开源软件的开发

在其他人分享的开源软件里。如果权限允许的话。你可以:

  • 申请成为软件的协作者,提交代码协助作者进行开发
  • 发现问题后提交Bug
  • 参与问题的讨论,有解决方案时可以帮助其他人

2.3 分享自己的软件

也就是将GitHub当作自己的软件仓库来使用。你可以先将自己的项目设定为私人,然后在适当的时机设定为公开,分享给所有人。

2.4 查找需要的软件

当我们要做一件事情找不到合适的软件时,不妨来这里找一找看。 或者我们在开发时遇到困难,不妨来这里找一找,看别人是如何解决这些困难的。 再或者我们可以随意浏览一下评价较高,使用人数很多的软件。也许就会找到我们喜欢的软件。

3. GitHub的限制

对于个人开发者的私人项目而言,是 完全免费 的,也没有任何的协作人数限制。

个人私有仓库的空间是无限的。但是我们应该按照GitHub的要求来合理使用。根据官方文档上的说法。

文件和仓库大小限制

文件和仓库大小限制

为确保用户的性能和可靠性,我们积极监控整个仓库运行状况的信号。 仓库运行状况是各种交互因素共同作用的结果,包括大小、提交频率、内容和结构。

建议仓库保持较小,理想情况下小于 1 GB,强烈建议小于 5 GB。 较小的仓库克隆速度更快,使用和维护更容易。 仓库中的单个文件严格限于 100 MB 的大小上限。 更多信息请参阅“使用大文件”。

如果您的仓库过度影响我们的基础架构,您可能会收到来自 GitHub 支持 的电子邮件,要求您采取纠正措施。 我们力求灵活,特别是对于拥有很多协作者的大型项目,并且尽可能与您一起找到解决方案。 您可以有效地管理仓库的大小和整体运行状况,以免您的仓库影响我们的基础架构。 在 github/git-sizer 仓库中可以找到用于仓库分析的建议和工具。

注:如果您通过浏览器将文件添加到仓库,该文件不得大于 25 MB。 更多信息请参阅“添加文件到仓库”。

这个大小对于通常的项目而言已经绰绰有余了。对于有大量资源文件的小型和中型游戏程序而言,5GB也已经足够了。

4. 建立自己的代码仓库

GitHub的一般功能,只需要我们在网页上鼠标点一点就行了。而建立自己的代码仓库则稍微复杂一些。

4.1 创建一个新的项目

步骤非常简单。

步骤 图示
1. 创建项目 创建项目
2. 设定基本信息 创建项目
3. 创建完成 创建项目

4.2 管理项目

在项目的设置页面中,我们可以修改项目的许多设置,还可以删除这个项目。

步骤 图示
1. 打开设置页面 创建项目
2. 修改项目名 创建项目
3. 修改可见性 创建项目
创建项目
4. 删除项目 创建项目

4.3 在Windows上安装GitHub客户端

GitHub已经提供了一个桌面版的客户端来简化我们的操作。这样我们就可以不用耗时费力使用命令行版的Git Bash工具了。

步骤 图示
1. 下载安装包 安装客户端
2. 克隆项目 安装客户端
3. 界面示例 安装客户端

然后我们来试一试提交文件上去。

步骤 图示
1. commit 提交文件
2. push 提交文件
3. 查看效果 提交文件

4.4 与Visual Studio Code协作

这里就需要我们安装Git的windows客户端了。

步骤 图示
1. 安装Git客户端 Git安装包下载地址
VSC
2. 安装GitLens插件 VSC
3. 查看效果 VSC

4.5 对常用文件的显示支持

上传到GitHub上的文档我们可以方便的在其他地方随意打开了,我们来看一看打开各种类型的文件的显示效果如何。

文件类型 显示效果
1. MarkDown 显示效果显示效果显示效果
2. Java源代码 显示效果
3. Excel文件 无法浏览文件内容
4. Word文档 无法浏览文件内容

可以看到,对于Markdown文件来说,相对路径上的图片可以被正常的显示出来。 而代码文件,理所当然没有任何问题。 但是Office系文件果然是没有办法直接看效果的。

而在手机上查看时,格式多多少少会有一些变化,有的样式不能被正确显示出来。