Github

• 使用目的：
  借助github托管代码

一、要了解的基本概念:

1. 仓库（Repository）

自己的项目，在Github上开源一个项目，必须新建一个仓库。每个项目对应一个仓库，多个开源项目对应多个仓库。

2. 收藏（Star）

仓库主页Star,收藏项目，方便自己查看

3. 复制克隆项目（Fork）

用户1建立一个test仓库，用户2看到后点击用户1的fork会将用户1的仓库完整复制过来，用户2将会看到一个单独存在的仓库在自己仓库页面（但是会显示仓库来自哪个用户）

验证用户2复制的仓库是否单独存在：用户2在自己的页面创建一个名称一样的仓库

4. 发起请求(pull Request)

复制用户1的仓库后，用户2可不可以动态添加代码呢？
答案：是可以的

用户2添加代码后，想要用户1也在它自己的仓库中添加代码，用户2需要发起请求，用户1收到后，觉得添加的代码好，用户1会合并仓库

5. 事务卡片（Issue）

发现代码bug，但目前没有成型代码，需要讨论时间或使用开源项目出现问题时使用

6. 关注（Watch）

这个所有人都会。。。。。

二、注册github账号

官方网址：Github.com
里面的邮箱要认真填写（验证）
注册之后会自动跳到下一个页面

现在这个私有仓库也免费开放了
下一页，不用填，是一个问卷调查，直接点击跳过

注意：因为Github在国外服务器，所以访问较慢或者无法访问
github主页

个人主页

三、创建仓库（Start a project）

1.目的：

一个git库对应一个开源项目，通过git管理git库
仓库名称一般为项目名称

2. 仓库主页

3.仓库管理

• 创建文件

• 返回仓库页查看

• 编辑文件

每修改一次，需要重新描述


再次回到仓库查看

每修改一次上面的commits提交次数都会改变

点击commits里面会有自己的修改记录

点击相应的文件会看到详细内容

• 删除文件
  
  
  
  删除文件的详细内容查看：和编辑文件相同

• 上传文件
  
  
  

• 搜索仓库文件
  可以用快捷键t(T)
  
  

四、下载/检出项目

点击download

五、Github Issue

发现bug或新特性

发现bug或新特性需要给另一方提示

对方收到后在主页显示

对方回复
状态切换

六、开源项目贡献流程

1. 新建Issue

向原项目开发者提交想法或者代码

2. Pull Request

fork项目
修改自己仓库的代码
发起pull request
等待原开发者审核，合并

七、Git安装和使用

目的：通过git管理和托管开源项目
Git官网地址：https://www.git-scm.com/download/win
下载好之后，安装在自己想安装的盘里
下一步：

下一步：
开始菜单目录名设置

选择使用命令行环境

之后全部默认next

检查git是否安装成功

键盘WIN+R输入cmd，或者在开始窗口输入cmd,打开运行界面

输入git，回车
出现以下界面说明安装成功

八、环境变量配置

鼠标右击我的电脑，双击属性

打开后，点击高级属性

九、Git环境配置

在注册号github账号的前提下（没有的需要注册）

1.鼠标在桌面右击出现

2.双击 Git Bash Here图标
之后出现

3.检查用户名和邮箱是否配置成功

在前两个操作的基础上输入下面代码

九、搭建git服务器（远程仓库）：统一的托管网站

4.Git秘钥生成

之后打开我的电脑
或者也可以采用下面方式检查
打开我的电脑，双击本地磁盘C，

在上面的路径下，找到.ssh文件，双击之后有两个子文件

5.将ssh文件夹中的公钥（ id_rsa.pub）添加到GitHub管理平台中，在GitHub的个人账户的设置中找到如下界面

title随便起一个，将公钥（ id_rsa.pub）文件中内容复制粘贴到key中，然后点击Ass SSH key就好啦，完成后如下界面

6 . 测试一下配置是否成功，在Git Bush命令框（就是刚才配置账号和邮箱的命令框）中继续输入以下命令，回车

出现上面内容配置成功

7.之后再次打开C盘，找到.ssh文件，下面有三个文件，本地和远程连接成功之后会出现第三个文件known_hosts,出现这个表明连接成功

十、在本地新建git项目。git init

可以自己在盘里新建一个Gitmyproject文件夹（文件夹名可以自己随意起）
之后在这个文件夹下新建一个记事本里面随便输入一些内容，保存。

建好之后鼠标在文件夹空白处右击，点击

之后输入git init,回车

十一、在远程建立git项目

https://github.com/new
下面的字符串就是远程项目的唯一标识符，有两种方式，HTTPS和ssh

十二、本地项目-远程项目关联

输入命令：git remote add origin git@github.com:用户名（写自己的用户名）/myGitProjectRemote.git
注意：绿色的是远程项目的唯一标识符

十三、第一次发布项目 （本地-远程）

git add . //文件-暂存区,add后面是“空格 点”就表示当前目录的所有文件
注意：add和点中间有一个空格！！！

git commit -m “注释内容” //暂存区-本地分支（默认master）

git push -u origin master

然后现在GitHub官网上就关联了本地项目：

十四、第一次下载项目（远程-本地）：git clone git@XXX

然后找一个存放该项目的文件夹（新建一个），并在此空文件夹里面右键【git bash here】，输入命令：git clone XXX （注意：“XXX”是刚刚复制的唯一标识符）

然后可以看到该项目就下载到刚刚新建的本地文件夹“gitmineproject”了。

十五、提交项目（本地-远程），三步走

修改之前文件中的内容

在当前工作目录，右键【git bash here】

git add .

git commit -m “提交内容”

git push origin master （注意：这是非第一次提交，所以没有“-u”）

刷新github

十六、更新项目（远程-本地），命令：git pull

回到github


添加成功后，在git bash here输入git pull

再次打开之前自己建的文件，会发现添加的内容在本地文件中也出现了

（注意：如果git pull命令报错了，可以试一下这个命令：git pull origin master）