github是一个基于Git的代码托管平台,付费用户可以建私人仓库,我们一般的免费用户只能使用公共仓库,也就是代码要公开。对于一般人来说公共仓库就已经足够了,而且我们也没多少代码来管理,O(∩_∩)O~。下面是我总结的一些简单使用方法,供初学者参考。
1.注册账户以及创建仓库
要想使用github第一步当然是注册github账号了。之后就可以创建仓库了(免费用户只能建公共仓库),Create a New Repository,填好名称后Create,之后会出现一些仓库的配置信息,这也是一个git的简单教程。2.安装客户端msysgit
github是服务端,要想在自己电脑上使用git我们还需要一个git客户端,我这里选用msysgit,这个只是提供了git的核心功能,而且是基于命令行的。如果想要图形界面的话只要在msysgit的基础上安装TortoiseGit即可。
装完msysgit后右键鼠标会多出一些选项来,在本地仓库里右键选择Git Init Here,会多出来一个.git文件夹,这就表示本地git创建成功。右键Git Bash进入git命令行,为了把本地的仓库传到github,还需要配置ssh key。
3.配置Git
首先在本地创建ssh key;
<ol class="linenums" style="margin-top:0px; margin-bottom:0px"><li class="L0" style="list-style-type:decimal"><code><span class="pln" style="color:#000000;">$ ssh</span><span class="pun" style="color:#66660;">-</span><span class="pln" style="color:#000000;">keygen </span><span class="pun" style="color:#66660;">-</span><span class="pln" style="color:#000000;">t rsa </span><span class="pun" style="color:#66660;">-</span><span class="pln" style="color:#000000;">C </span><span class="str" style="color:#0880;">"your_email@youremail.com"</span></code></li></ol>
后面的your_email@youremail.com改为你的邮箱,之后会要求确认路径和输入密码,我们这使用默认的一路回车就行。成功的话会在~/下生成.ssh文件夹,进去,打开id_rsa.pub,复制里面的key。
回到github,进入Account Settings,左边选择SSH Keys,Add SSH Key,title随便填,粘贴key。为了验证是否成功,在git bash下输入:
<ol class="linenums" style="margin-top:0px; margin-bottom:0px"><li class="L0" style="list-style-type:decimal"><code><span class="pln" style="color:#000000;">$ ssh </span><span class="pun" style="color:#66660;">-</span><span class="pln" style="color:#000000;">T git@github</span><span class="pun" style="color:#66660;">.</span><span class="pln" style="color:#000000;">com</span></code></li></ol>
如果是第一次的会提示是否continue,输入yes就会看到:You've successfully authenticated, but GitHub does not provide shell access 。这就表示已成功连上github。
接下来我们要做的就是把本地仓库传到github上去,在此之前还需要设置username和email,因为github每次commit都会记录他们。
<ol class="linenums" style="margin-top:0px; margin-bottom:0px"><li class="L0" style="list-style-type:decimal"><code><span class="pln" style="color:#000000;">$ git config </span><span class="pun" style="color:#66660;">--</span><span class="kwd" style="color:#0088;">global</span><span class="pln" style="color:#000000;"> user</span><span class="pun" style="color:#66660;">.</span><span class="pln" style="color:#000000;">name </span><span class="str" style="color:#0880;">"your name"</span></code></li><li class="L1" style="list-style-type:decimal; background-color:rgb(238,238,238)"><code><span class="pln" style="color:#000000;">$ git config </span><span class="pun" style="color:#66660;">--</span><span class="kwd" style="color:#0088;">global</span><span class="pln" style="color:#000000;"> user</span><span class="pun" style="color:#66660;">.</span><span class="pln" style="color:#000000;">email </span><span class="str" style="color:#0880;">"your_email@youremail.com"</span></code></li></ol>
进入要上传的仓库,右键git bash,添加远程地址:
<ol class="linenums" style="margin-top:0px; margin-bottom:0px"><li class="L0" style="list-style-type:decimal"><code><span class="pln" style="color:#000000;">$ git remote add origin git@github</span><span class="pun" style="color:#66660;">.</span><span class="pln" style="color:#000000;">com</span><span class="pun" style="color:#66660;">:</span><span class="pln" style="color:#000000;">yourName</span><span class="pun" style="color:#66660;">/</span><span class="pln" style="color:#000000;">yourRepo</span><span class="pun" style="color:#66660;">.</span><span class="pln" style="color:#000000;">git</span></code></li></ol>
后面的yourName和yourRepo表示你再github的用户名和刚才新建的仓库,加完之后进入.git,打开config,这里会多出一个remote “origin”内容,这就是刚才添加的远程地址,也可以直接修改config来配置远程地址。
4.提交、上传
接下来在本地仓库里添加一些文件,比如README,
<ol class="linenums" style="margin-top:0px; margin-bottom:0px"><li class="L0" style="list-style-type:decimal"><code><span class="pln" style="color:#000000;">$ git add README</span></code></li><li class="L1" style="list-style-type:decimal; background-color:rgb(238,238,238)"><code><span class="pln" style="color:#000000;">$ git commit </span><span class="pun" style="color:#66660;">-</span><span class="pln" style="color:#000000;">m </span><span class="str" style="color:#0880;">"first commit"</span></code></li></ol>
上传到github:
<ol class="linenums" style="margin-top:0px; margin-bottom:0px"><li class="L0" style="list-style-type:decimal"><code><span class="pln" style="color:#000000;">$ git push origin master</span></code></li></ol>
git push命令会将本地仓库推送到远程服务器。
git pull命令则相反。
修改完代码后,使用git status可以查看文件的差别,使用git add 添加要commit的文件,也可以用git add -i来智能添加文件。之后git commit提交本次修改,git push上传到github。
5.gitignore文件
.gitignore顾名思义就是告诉git需要忽略的文件,这是一个很重要并且很实用的文件。一般我们写完代码后会执行编译、调试等操作,这期间会产生很多中间文件和可执行文件,这些都不是代码文件,是不需要git来管理的。我们在git status的时候会看到很多这样的文件,如果用git add -A来添加的话会把他们都加进去,而手动一个个添加的话也太麻烦了。这时我们就需要.gitignore了。比如一般c#的项目我的.gitignore是这样写的:
<ol class="linenums" style="margin-top:0px; margin-bottom:0px"><li class="L0" style="list-style-type:decimal"><code><span class="pln" style="color:#000000;">bin</span></code></li><li class="L1" style="list-style-type:decimal; background-color:rgb(238,238,238)"><code><span class="pun" style="color:#66660;">*.</span><span class="pln" style="color:#000000;">suo</span></code></li><li class="L2" style="list-style-type:decimal"><code><span class="pln" style="color:#000000;">obj</span></code></li></ol>
bin和obj是编译目录,里面都不是源代码,忽略;suo文件是vs2010的配置文件,不需要。这样你在git status的时候就只会看到源代码文件了,就可以放心的git add -A了。
6.tag
我们可以创建一个tag来指向软件开发中的一个关键时期,比如版本号更新的时候可以建一个“v2.0”、“v3.1”之类的标签,这样在以后回顾的时候会比较方便。tag的使用很简单,主要操作有:查看tag、创建tag、验证tag以及共享tag。6.1查看tag
列出所有tag:
<ol class="linenums" style="margin-top:0px; margin-bottom:0px"><li class="L0" style="list-style-type:decimal"><code><span class="pln" style="color:#000000;">git tag</span></code></li></ol>
这样列出的tag是按字母排序的,和创建时间没关系。如果只是想查看某些tag的话,可以加限定:
<ol class="linenums" style="margin-top:0px; margin-bottom:0px"><li class="L0" style="list-style-type:decimal"><code><span class="pln" style="color:#000000;">git tag </span><span class="pun" style="color:#66660;">-</span><span class="pln" style="color:#000000;">l v1</span><span class="pun" style="color:#66660;">.*</span></code></li></ol>
这样就只会列出1.几的版本。
6.2创建tag
创建轻量级tag:
<ol class="linenums" style="margin-top:0px; margin-bottom:0px"><li class="L0" style="list-style-type:decimal"><code><span class="pln" style="color:#000000;">git tag v1</span><span class="pun" style="color:#66660;">.</span><span class="lit" style="color:#06666;">0</span></code></li></ol>
这样创建的tag没有附带其他信息,与之相应的是带信息的tag:
<ol class="linenums" style="margin-top:0px; margin-bottom:0px"><li class="L0" style="list-style-type:decimal"><code><span class="pln" style="color:#000000;">git tag </span><span class="pun" style="color:#66660;">-</span><span class="pln" style="color:#000000;">a v1</span><span class="pun" style="color:#66660;">.</span><span class="lit" style="color:#06666;">0</span><span class="pln" style="color:#000000;"> </span><span class="pun" style="color:#66660;">-</span><span class="pln" style="color:#000000;">m </span><span class="str" style="color:#0880;">'first version'</span></code></li></ol>
-m后面带的就是注释信息,这样在日后查看的时候会很有用,这种是普通tag,还有一种有签名的tag:
<ol class="linenums" style="margin-top:0px; margin-bottom:0px"><li class="L0" style="list-style-type:decimal"><code><span class="pln" style="color:#000000;">git tag </span><span class="pun" style="color:#66660;">-</span><span class="pln" style="color:#000000;">s v1</span><span class="pun" style="color:#66660;">.</span><span class="lit" style="color:#06666;">0</span><span class="pln" style="color:#000000;"> </span><span class="pun" style="color:#66660;">-</span><span class="pln" style="color:#000000;">m </span><span class="str" style="color:#0880;">'first version'</span></code></li></ol>
前提是你有GPG私钥,把上面的a换成s就行了。除了可以为当前的进度添加tag,我们还可以为以前的commit添加tag:
<ol class="linenums" style="margin-top:0px; margin-bottom:0px"><li class="L0" style="list-style-type:decimal"><code><span class="com" style="color:#8800;">#首先查看以前的commit</span></code></li><li class="L1" style="list-style-type:decimal; background-color:rgb(238,238,238)"><code><span class="pln" style="color:#000000;">git log </span><span class="pun" style="color:#66660;">--</span><span class="pln" style="color:#000000;">oneline </span></code></li><li class="L2" style="list-style-type:decimal"><code><span class="com" style="color:#8800;">#假如有这样一个commit:8a5cbc2 updated readme</span></code></li><li class="L3" style="list-style-type:decimal; background-color:rgb(238,238,238)"><code><span class="com" style="color:#8800;">#这样为他添加tag</span></code></li><li class="L4"><code><span class="pln" style="color:#000000;">git tag </span><span class="pun" style="color:#66660;">-</span><span class="pln" style="color:#000000;">a v1</span><span class="pun" style="color:#66660;">.</span><span class="lit" style="color:#06666;">1</span><span class="pln" style="color:#000000;"> </span><span class="lit" style="color:#06666;">8a5cbc2</span></code></li></ol>
6.3删除tag
很简单,知道tag名称后:
<ol class="linenums" style="margin-top:0px; margin-bottom:0px"><li class="L0" style="list-style-type:decimal"><code><span class="pln" style="color:#000000;">git tag </span><span class="pun" style="color:#66660;">-</span><span class="pln" style="color:#000000;">d v1</span><span class="pun" style="color:#66660;">.</span><span class="lit" style="color:#06666;">0</span></code></li></ol>
6.4验证tag
如果你有GPG私钥的话就可以验证tag:
<ol class="linenums" style="margin-top:0px; margin-bottom:0px"><li class="L0" style="list-style-type:decimal"><code><span class="pln" style="color:#000000;">git tag </span><span class="pun" style="color:#66660;">-</span><span class="pln" style="color:#000000;">v v1</span><span class="pun" style="color:#66660;">.</span><span class="lit" style="color:#06666;">0</span></code></li></ol>
6.5共享tag
我们在执行git push的时候,tag是不会上传到服务器的,比如现在的github,创建tag后git push,在github网页上是看不到tag的,为了共享这些tag,你必须这样:
转自:http://wuyuans.com/2012/05/github-simple-tutorial/
<ol class="linenums" style="margin-top:0px; margin-bottom:0px"><li class="L0" style="list-style-type:decimal"><code><span class="pln" style="color:#000000;">git push origin </span><span class="pun" style="color:#66660;">--</span><span class="pln" style="color:#000000;">tags</span></code></li></ol>