GitHub完整使用教程

                                                            TortoiseGit使用笔记（windows下使用上传数据到GitHub）

作为开源代码库以及版本控制系统，Github拥有140多万开发者用户。随着越来越多的应用程序转移到了云上，Github已经成为了管理软件开发以及发现已有代码的首选方法 ,Git已经成为程序员必备技能之一，而GitHub做为做流行的Git仓库托管平台，其不仅提供Git仓库托管，还是一个非常棒的技术人员社交平台，可以通过开源的项目进行协作、交流，是现在优秀的工程师必须娴熟运用的。

为什么使用TortoiseGit，因为TortoiseGit只是一个界面，易于用户操作的。TortoiseGit是一个开放的,为的git版本控制系统的源客户端.像一个普通的文件服务器,除了会记得您有史以来的文件和目录的每一个变化外,还可以恢复您的文件的旧版本,并研究如何以及何时改变了历史数据,谁改变了它.当新手上传代码时会发现Git工具通过命令的方式操作起来太麻烦，所以推出tortoiseGIT供新手学习...废话不多说,让我们开始吧...

一、首先到 https://tortoisegit.org/download/ 上下载下来32-bit或者64-bit的*.msi文件，如下图：

大家还看到，上图中的下方有“Language Packs”，所以如果英文学得不是很好的朋友或者初学者，可以考虑下载“Chinesesimplified”这个中文包。然后安装刚才下好的TortoiseGit，安装完毕以后，接下来运行刚才下载好的中文包。然后一切顺利的话，就下载好了。

二、 工具都准备好了，开始跟GitHub交互了，也就是大家希望的往GitHub开源代码托管库提交数据了。

(1) 首先我们要运行TortoiseGit下的Puttygen，可以通过“开始”找到：

                                 

运行开始后，就可以点击“Generate”（产生），来生成密钥了，这个是方便公钥与私钥加密的，这个有兴趣的朋友，可以了解一下RSA加密技术。但是值得注意的是最下边的“Type of key togenerate”使用默认的方式“SSH-2 RSA”方式，这是github的要求。生成完密钥，应该保存一下，以方便后边的使用，尽量保存到自己方便找的地方，也可以和自己之前的安装目录放到一起。

                      

(2)然后就可以开始到http://www.github.com上去申请自己的账号了，此处略去。登录以后在网站的右下方，有如下图的一个“New repository”，点击建立一个新的仓库，如果使用过SVN的朋友都应该懂得，就是放自己代码的地方。

                       

这样子，自己的仓库就建好了，然后就开始配置SSH，就是刚才用Puttygen什么的那个密钥的相关配置。

 (3) 点击当前网页右上角的这个图标，然后选择左边的“SSH andGPG Keys”，选择“Add SSH Key”，Title随便取个名字，但是尽量规范一些（方便自己以后有多个key时区分）。把刚才产生的那个Puttygen私钥，复制粘贴到Title下边的Key中，就可以了。这样子，我们就配置SSH Key完成了。

(4)首先我们在电脑的某个地方新建一个文件夹（路径尽量不要含有中文，因为好像上传的时候中文的就会出现一定的问题）。然后右键该文件夹，单击“GitClone”，然后就可以从GitHub上克隆下来原有的数据（一定要执行）。完事以后，我们就会发现多了我们当时建立的一个库文件。

                        

(5)这时候我们就在刚才克隆下来的仓库中新建一个.txt文本，进行测试。操作具体如下图：

（6）增加完，我们就可以提交了

提交完了，很多朋友，特别是用过SVN的朋友都以为结束了，其实去GitHub上查看，竟然没有，也许会郁闷一下。其实也好理解，例如大家都知道在数据库中的操作中，会有提交和回滚操作。其实这里的commit相当于先把数据放到了缓存中（也许不太恰当）。然后还要拉到GitHub的仓库中。操作为退到仓库文件的文件夹下，如下操作：

                                                               

这时候，我们去自己的GitHub上查看，发现已经存在了刚才上传的文件。

自己学习过程，遇到了一些问题，走了点弯路，所以一定要从了解这个东西的原理开始学起，然后才可以抓住主线进行学习。

到此可能你以为结束了,不好意思你错了,我现在给大家列举一些经常出现的错误;

1.git 未能顺利结束 (退出码 1) (3510 ms @ 2014/11/29 23:51:56)  

说明: 如果 GitHub 在线仓库只有一个分支, 也就是 master 时， Pull 拉取就不报错, 如果在线的远端仓库有多个分支，如 master 加上 gh-pages 时,一拉取就报这个错. 但使用 git 命令行就没有这个问题. 那么问题来了, 肯定是 TortoiseGit 的哪里配置不对

查看方法:

        打开Git项目根目录, 找到 .git 文件夹,进去里面编辑 config 这个文件,注意此文件没有后缀.

     还可以在项目根目录下点击鼠标右键, 选择 TortoiseGit --> Settings(设置 S), 然后选择左边的 Git --> 右边的 编辑本地.git/config 按钮,即可打开这个文件,如下图所示:

需要注意的是,因为远端有多个分支,所以这个配置文件里,相应的就多了一个小节 [branch "master"],而 这个小节下面的 remote = origion, 现在加上 master 变为:

保存,再次测试,OK，可以正常拉取

如果是别的错误码,请先选择项目右键还原，然后看看配置那里有什么问题不,如果没有按照小编

说的应该是没有问题...如果还有什么问题可以给我留言...后面会写一些更加深入的Github功能介绍.