GitHub 入门教程(一)

GitHub 准备工作

git：是一个软件，是版本管理工具（其他的一些工具如CVS），是可以在你电脑不联网的情况下，只在本地使用的一个版本管理工具，其作用就是可以让你更好的管理你的程序，比如你原来提交过的内容，以后虽然修改了，但是通过git这个工具，可以把你原来提交的内容重现出来，这样对于你后来才意到的一些错误的更改，可以进行还原。

github：是一个网站，利用Git提供免费的代码托管服务的网站（类似的网站还有老牌的SourceForge）,就是每个程序员自己写的程序，可以在github上建立一个网上的仓库，你每次提交的时候可以把代码提交到网上，这样你的每次提交，别人也都可以看到你的代码，同时别人也可以帮你修改你的代码，这种开源的方式非常方便程序员之间的交流和学习。

Repositorie（仓库）:一个Git仓库是一个包含所有用于维护和管理项目的版本和历史信息的数据库。

1.注册github账号

本人已经注册了，原谅我无法演示完整的注册过程。

2.安装git

双击：Git-2.13.1-64-bit.exe ,一直next，直到Install。

安装完后在Windows开始菜单就可以找到Git Bash，之后的命令就在这里输入。

3.创建SSH Key

在用户主目录下，看看有没有.ssh（我的在：C:\Users\Hadis.ssh）目录，如果有，再看看这个目录下有没有id_rsa和id_rsa.pub这两个文件，如果已经有了，可直接跳到下一步。如果没有，打开Shell（Windows下打开Git Bash），创建SSH Key：
$ ssh-keygen -t rsa -C “[e-mail]” //填写email地址，然后“回车”ok
打开本地…ssh\id_rsa.pub文件，此文件里面内容为刚才生成人密钥：

登陆github系统。点击右上角的你的头像 Settings—>SSH and GPG keys —>New SSH key：

打开git ，测试连接是否成功：

提示：如果显示 Hi defnngj You’ve successfully authenticated, but GitHub does not provide shell access. 说明你连接成功了
为什么GitHub需要SSH Key呢？因为GitHub需要识别出你推送的提交确实是你推送的，而不是别人冒充的，而Git支持SSH协议，所以，GitHub只要知道了你的公钥，就可以确认只有你自己才能推送。当然，GitHub允许你添加多个Key。假定你有若干电脑，你一会儿在电脑A提交，一会儿在电脑B提交，只要把每台电脑的Key都添加到GitHub，就可以在每台电脑上往GitHub推送了。

4.设置提交者信息

初始情况下，在每次提交的时候，你都需要设置，这次提交的用户的信息。 很明显的是，这很烦人，幸好的是Git提供了指定默认的提交者信息的方法：
gitconfig–globaluser.nameYourName git config –global user.email [e-mail]
提示： Your Name：就是你的用户名
email@example：就是你自己注册账号的邮箱。

创建项目

1.回到github首页，点击页面你头像旁边的加号，选择“New Repository”

2.填写你的项目信息

提示：私有项目是要付费的

3.初始化本地版本仓库

提示：需要使用git在本地创建一个名称相同的项目

4.查看Demo文件夹

提示：你也可以使用 ls –a 指令查看当前文件目录
Git就把仓库建好了，它是一个空的仓库（empty Git repository）， .git 目录是Git来跟踪管理版本库的，没事千万不要手动修改这个目录里面的文件，不然改乱了，就把Git仓库给破坏了。

5.添加文件到本地仓库

提示：此时还没有真正提交到版本库,只是放在暂存区。

提示：-m 的意思是”first commit” 是描述信息，你可以随便写。

提示：git log 指令是查看日志信息（没事经常可以多用用这个指令）。

6.将本地仓库与远程仓库互联

提示：origin 是 [e-mail]:hanwind/Demo.git项目所在地址的别名，之后就直接可以用origin代替远程项目地址名，[e-mail]:hanwind/Demo.git 中 hanwind是我的用户名（你需要输入你自己的），Demo是我的建立的项目名（你的项目名称是什么你就输入什么）。

提示：将本地项目更新到github项目上去，其中master是你当前的分支（$ git branch 可以查看你当前的分支，其中带有*号的是当前分支）。

提示：查看github上面的Demo项目，发现已经将本地中的README文件更新上来了。注意进行第一次推送master分支的所有内容，所以远程github上确保你的版本库是空的，否则你在这一步可能会不成功。此后每次本地提交后，只要有必要，就可以使用命令 git push origin master 推送最新修改。

7.将远程仓库的项目下载到本地

提示：因为我执行clone指令的时候是在Demo目录下，所以我的远程的Demo项目就下载到Demo文件夹下，当然也可以切换到别的目录，然后再下载，我们试一试：

8.更新本地仓库到远程仓库

应用场景：比如你再本地仓库修改或者增加了新的文件，需要更新到远程仓库。

提示：echo指令已经新建了一个文件cpp

提示：已经将本地的main.cpp更新到了远程仓库

常见问题

1.提示”Permission denied（publicky）”，说明你的SSH密钥没有配置，重复创建SSH Key即可。

2.提示”remote origin already exits”，说明你的远程仓库origin已经存在，其中origin是你远程仓库地址[e-mail]:hanwind/yourgit.git的别名，yourgit是你的项目名称。

3.”updates were rejected because the remote contains wo not have locally”,就是说远程服务器上项目有的文件，本地仓库内的项目没有该文件。

例如：我查看远程服务器上Demo项目有README.md,但是本地没有这个文件。

可以通过如下命令进行代码合并【注：pull=fetch+merge]
git pull –rebase origin master

再执行语句 git push -u origin master即可完成代码上传到github。

4.删除一个Github上的项目
进入你要删除的“Repositories”后，点击“Setting”：

点击Delete this reposity：

提示：此处提示信息，就是警告你，删除了就没有这个项目了，操作需谨慎！输入你的项目名，之后点击”I understand the consequences，delete this repository”完成删除操作。