跳至正文

github初学者教程

GitHub is a web-based version-control and collaboration platform for software developers.

GitHub 是一个面向软件开发人员的基于 Web 的版本控制和协作平台

本教程适用于不熟练/不会使用git,且又想使用代码托管平台的初学者

那么我们首先假设你已经注册完成了github账号,并且验证了自己的邮箱

那么,在简单的登录过后,你会看到如下类似的界面,这里会展示一些你关注的人的动态,以及一些推荐的项目:

登陆后github的主页

第一步:新建储存库

如果你想托管自己的代码,那么新建一个储存库是必不可少的

首先,点击右上角的“+”号,在下拉菜单中选择new repository,然后填写一些关于这个仓库的信息

翻译后创建仓库的界面

参考上面这张图,你应该就很快的了解了这些选项都是干什么的了

注意!这里有几个点需要你在创建仓库的时候选择

  1. Public和Private的区别:

Public 意为公共的,共有的。当你选择了该选项后,你的代码储存库将会可见、可搜索,但这并不意味着你的代码可以随意被他人编辑,他们需要发起Pull Requests,并且需要经过你的同意,才可以对代码进行修改

Private 意思则反之,意为私有的,自己的。当你选择了这一项之后,你的代码库将从github中“隐身”,只有你选中的人(或者你自己)才可以查看并修改代码库,这一选项适用于隐私性较强的项目(同样也适用于未完成的项目)

至于其他的选项,就比较好理解了

  1. Add a README file

这是一个在创建储存库后,自动添加储存库自述文件(即README文件),它会显示在创建仓库后代码去的下方(效果可以见github/.github: Community health files for the @GitHub organization

2. Add .gitignore

这是添加一个git忽略文件的选项,目前暂时是用不到的,后面会解释

3. Choose a license

这个选项用于在创建仓库后自动附上一个许可证,它规定了其他人可以怎样使用你的代码(例如可商业使用或者非商业使用),选择许可证可以参考这6种开源协议(GPL,LGPL,BSD,MIT,Apache)的说明和选择 – 云+社区 – 腾讯云 (tencent.com)

选择许可证的界面

当然,当你全部选择完毕了之后,点击最下方的“Create repository”,你就完成了一个仓库的创建,并且README文件中会默认包含你的仓库的名字和描述

创建仓库后展示的界面

当然,如果在创建仓库的时候,以上三个选项都没有选择的话,会出现这样一个界面:

一个空仓库提示界面

第二步:上传自己的代码

那么我们假设你有一些代码需要上传

一个测试文件

接下来,把你的所有代码,拖放到github仓库页面上,然后会出现一个提示框,提醒你松开上传

提醒你松开上传的状态

松开鼠标后,你会看到这样一个页面

手动上传时代码提交界面
手动上传时代码提交界面(翻译后)

你可以选择什么都不填,直接点击Commit Changes,或者填写可选的注释

点击后,你的代码就可以被上传到储存库了,你可以通过点击它们查看内容

查看自己上传的代码

第三步:编辑代码

那么如何在修改储存库中的代码呢?有人肯定会说:“重复上一步不就行了?”

虽然这种方法也行,但是毕竟麻烦啊

你可以进入你想修改的代码,并且点击代码框体的右上角啊,有一个铅笔,上面写着Edit this file,点它就完了!

图标与字样

接下来,你就可以随心所欲的修改代码了

当你修改完成之后,滚动到页面最下方,有一个类似第二步提交的框体,你可以直接像是上一步一样,点击“Commit Changes”,或者添加可选的注释

完成之后,你的代码就被修改了!

查看自己修改的代码

隐藏技能:使用网页版vscode

当然,以上这些步骤仍然很繁琐,这里补充一个简便的方法

回到仓库主页后,点击键盘上的“.”键,稍等一会,你就会跳转到github web editor,接下来,你就可以像是使用vscode一类的IDE一样编写代码了

当编写完成后,你需要点击“source control”,并且点击这个+号,暂存所有更改

暂存所有更改

然后点击这个箭头提交更改,并且填写注释(没错,在这里就必须要填写注释了)

提交更改

最后,回到仓库,你就可以看到修改了!

修改后的代码
标签:

发表回复

您的电子邮箱地址不会被公开。 必填项已用*标注