Github快速入门手册

最近在试用Github，开源的思想也让人觉得把一些经验分享出来是非常好的事情。附件是doc文件，如有需要请注意查收。希望能对你有帮助。

GITHUB基于互联网的版本控制快速入门手册

如有不妥，欢迎指正

转载请注明出处！

Github介绍wiki：http://en.wikipedia.org/wiki/GitHub

Github官网：https://github.com/

如果你还在用cvs、或者svn或者还有什么其他balabala的版本控制工具，那么你就out了。如果你还不知道Github，那么现在你的机会来了。

在 2005年，Linus Torvalds(Linux之父)为了解决在处理Linux内核上的补丁程序遇到的问题而开发了Git版本控制系统。几年之后，出现了以Git为基础的 具有漂亮的web使用界面的GitHub，这使得对这个平台上的项目进行分支操作，打补丁，和提交代码等都变得异常简单容易。它采用的标准化的wiki和 问题跟踪系统，这意味着所有的项目是按同一种方式搭建起来的。一旦你学会了如何向GitHub上的一个项目提交代码，你也就知道了如何向其它所有项目提交 代码了。

其实最重要的是你知道或者能使用那就更好了，同时能增加你在与客户沟通谈资中的亮点哦。下面，我们将简单地介绍和使用Github来实现基本的版本控制。当然你也可以直接看官方更详细的文档，如果你愿意借鉴本文档中的一些东西，也保留的你权利。

优点：

1.      方便的合并和派生机制，可以在任意版本上派生和合并

2.      社交化的版本库，只不过这是一个私有的，公共视图不可见的库。

3.      基于互联网的存储和分布，相当于在互联网上的分布式版本库。

前提：

为了之后的操作方便，你如果愿意可以去github.com 注册一个账户，for free。

一、安装和配置

（1）.下载安装可参见：http://help.github.com/win-set-up-git/，以下仅以windows为例

安装完成，在windows中启动Github，可见如下界面，

到这里你已经完成了一大步了，下面我们继续。

（2）生成SSH key

在如上图中的bash界面输入：

当然黄色部分，你可以换成你的Email地址和相应的目录，在提示的时候输入你希望的到时用ssh连接版本库的公钥密码。

公钥生成完成后，将会看到类似上图的界面。并在你设定的相应的目录下产生一个 .ssh文件，里面的id_rsa.pub文件将是我们接下来所需要的（前提是你必须设置隐藏文件可见，在windows中的话）。

（3）将你的ssh key与Github账号绑定

在Dashboard首页右上方，操作1

在
AccountSetting界面依次点左侧，“SSHPublic Keys” 然后“Add Another public
key”，将上面创建ssh key后，所在目录下的.ssh目录中id_rsa.pub文件内容拷贝并复制到下图所示框中（Title不是必填项

再点add key，OK，完成这一步。

（4）测试

在Github的bash界面输入如下

在如下界面输入“yes“

正常情况下会出现如下界面，至此安装部分基本结束。

（5）配置用户名和邮件信息

其中黄色部分你可以换成你的个人名字和email

（6）配置Github token

在Dashboard首页右上方，然后点account settings，在图中位置中你的信息token复制

你可以在Github的bash界面用ctrl+insert键粘贴剪切板中的内容。

最后，在bash中如入如上命令，即可完成配置。

二、创建版本库

（1）在dashboard首页，右下角点“new repository”

（2）填写项目信息，然后点“create Reporsitory”，

（3）这一步，我们将提交一份文件至版本库，代码可以相同的方式提交

Github的bash其实有点像linux的bash，你可以打开vi，也可以执行linux命令，当然不是所有的命令都有，至少常见的命令是有的。

我们依次要执行的命令有

创建目录、进入目录、git初始化、创建文件（上传版本库的上传文件）

（4）将你的本地的Github仓库与Github账户连接，（当然你必须进入相应的带.git的文件目录下，不然会提示你不能找到.git文件。.git文件存在于你执行git init后初始化的目录中）

文件提交

用过svn的同学大概能想起点什么来了。

你将能看到类似如下的界面，

至此，你已经学会文件提交了。

·连接远程版本库：

下次使用，打开bash后，输入

$ ssh –v git@github.com 就能连接远程版本库了.

·提交已存在文件：

如果对已存在文件提交，可以直接使用

$ git commitfilename –m ‘message’其中黄色部分可按照实际情况填写。此提交将文件提交至本地存储版本库中。若要提交至远程账户，可执行以下命令

$ git push origin master至此，文件已与Github账户所在的版本库同步。

·本地与服务器版本同步（可参照下图中的命令）：

这个同步功能有些不太好使，如果在linux上，你用sshFQ后，可能效果会更好

三、派生新版本

你可以选择先从版本库中取一份拷贝到你的本地，相当于checkout一份，如SVN中：

$ git clone git@github.com:username/Spoon-Knife.git

如黄色部分可替换为你的信息

然后配置远程属性，

这里有几个概念，通过clone下来的版本有一个默认的远程名叫“origin”。此origin与你Github账户拥有的版本库的主版本不同。如果需要追踪主版本，可以使用另外一个远程名“upstream”。

更多功能：

1.      你还可以将主版本中的文件更新至你的分支版本库中或者合并（对于你的分支版本操作）

2.      你还可以向主版本发起合并请求，等待相关人员将你的代码加入主版本

3.      删除分支版本、脱离主版本等

还有社交化的功能等着你去摸索。比如你可以查看你关注的人正在进行的项目，你可以加入别人正在开发的项目，建立分支。然后写代码，再然后，提交代码。如果你正在考虑使用什么版本控制工具，在这里强烈推荐Github。