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安装包下载地址![]() |
| 2. 安装GitLens插件 | ![]() |
| 3. 查看效果 | ![]() |
4.5 对常用文件的显示支持
上传到GitHub上的文档我们可以方便的在其他地方随意打开了,我们来看一看打开各种类型的文件的显示效果如何。
| 文件类型 | 显示效果 |
|---|---|
| 1. MarkDown | ![]() ![]() ![]() |
| 2. Java源代码 | ![]() |
| 3. Excel文件 | 无法浏览文件内容 |
| 4. Word文档 | 无法浏览文件内容 |
可以看到,对于Markdown文件来说,相对路径上的图片可以被正常的显示出来。 而代码文件,理所当然没有任何问题。 但是Office系文件果然是没有办法直接看效果的。
而在手机上查看时,格式多多少少会有一些变化,有的样式不能被正确显示出来。




















