github是一个基于git的代码托管平台，付费用户可以建私人仓库，我们一般的免费用户只能使用公共仓库，也就是代码要公开。对于一般人来说公共仓库就已经足够了，而且我们也没多少代码来管理，O(∩_∩)O~。下面是我总结的一些简单使用方法，供初学者参考。
1、注册账户以及创建仓库
要想使用github第一步当然是注册github账号了。之后就可以创建仓库了（免费用户只能建公共仓库），Create a New Repository，填好名称后Create，之后会出现一些仓库的配置信息，这也是一个git的简单教程。（注意：github上的仓库是不能通过在客户端通过git remote add https://username@github.com/username/reponame.git等命令来创建的，git remote add命令只是用来添加本地代码关联的远程代码地址，后面会详细介绍）。
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；
|
1
|
$ ssh-keygen -t rsa -C "your_email@youremail.com" |
后面的your_email@youremail.com改为你的邮箱，注意邮箱地址必须是github注册时的邮箱地址，之后会要求确认路径和输入密码，我们这使用默认的一路回车就行。成功的话会在~/下生成.ssh文件夹，进去，打开id_rsa.pub，复制里面的key。
回到github，进入Account Settings，左边选择SSH Keys，Add SSH Key,title随便填，粘贴key。为了验证是否成功，在git bash下输入：
|
1
|
$ ssh -T git@github.com |
如果是第一次的会提示是否continue，输入yes就会看到：You’ve successfully authenticated, but GitHub does not provide shell access 。这就表示已成功连上github。
接下来我们要做的就是把本地仓库传到github上去，在此之前还需要设置username和email，因为github每次commit都会记录他们。
|
1
2
|
$ git config --global user.name "your name"$ git config --global user.email "your_email@youremail.com" |
进入要上传的仓库，右键git bash，添加远程地址：
|
1
|
$ git remote add origin git@github.com:yourName/yourRepo.git |
后面的yourName和yourRepo表示你再github的用户名和刚才新建的仓库，加完之后进入.git，打开config，这里会多出一个remote “origin”内容，这就是刚才添加的远程地址，也可以直接修改config来配置远程地址。（注意git remote add添加的远程地址必须是存在的，即在github上已经建好的）
4.提交、上传
接下来在本地仓库里添加一些文件，比如README，
|
1
2
|
$ git add README$ git commit -m "first commit" |
上传到github：
|
1
|
$ git push origin master |
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 是这样写的：
|
1
2
3
|
bin*.suoobj |
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：
|
1
|
git tag |
这样列出的tag是按字母排序的，和创建时间没关系。如果只是想查看某些tag的话，可以加限定：
|
1
|
git tag -l v1.* |
这样就只会列出1.几的版本。
6.2创建tag
创建轻量级tag：
|
1
|
git tag v1.0 |
这样创建的tag没有附带其他信息，与之相应的是带信息的tag：
|
1
|
git tag -a v1.0 -m 'first version' |
-m后面带的就是注释信息，这样在日后查看的时候会很有用，这种是普通tag，还有一种有签名的tag：
|
1
|
git tag -s v1.0 -m 'first version' |
前提是你有GPG私钥，把上面的a换成s就行了。除了可以为当前的进度添加tag，我们还可以为以前的commit添加tag：
|
1
2
3
4
5
|
#首先查看以前的commitgit log --oneline #假如有这样一个commit：8a5cbc2 updated readme#这样为他添加taggit tag -a v1.1 8a5cbc2 |
6.3删除tag
很简单，知道tag名称后：
|
1
|
git tag -d v1.0 |
6.4验证tag
如果你有GPG私钥的话就可以验证tag：
|
1
|
git tag -v v1.0 |
6.5共享tag
我们在执行git push的时候，tag是不会上传到服务器的，比如现在的github，创建tag后git push，在github网页上是看不到tag的，为了共享这些tag，你必须这样：
|
1
|
git push origin --tags |
下面讲解一下注意事项：
1、ssh-keygen生成key时的邮箱必须是注册github时使用的邮箱。
2、【git remote add origin 代码地址 】 命令中origin是远程代码的分支，如果分支不是origin则写成别的。同时，该条命令不会再github上创建新的仓库，即命令中的地址必须是存在的否则push时会出错。
3、
下面讲一下具体情形：
当然必须完成的步骤是：
（1）使用ssh-keygen生成密钥。并将密钥公钥添加到github中。
ssh-keygen -t rsa -C "duhaizhang@gmail.com"
（2）使用git config来配置同户名和邮件地址。
git config --global user.name "jinglingshu"
git config --global user.email "duhaizhang@gmail.com"一、本地已经有代码，将其放到github中去管理。
1、在github中创建仓库，获取仓库地址，如git@github.com:jinglingshu1/test.git，注意创建仓库时千万不要选Initialize this repository with a README，即保证创建的仓库时空的，否则一会提交会很麻烦。
2、右键 本地代码文件夹来执行下面命令
（1）git init 初始化
（2） git remote add origin git@github.com:yourName/yourRepo.git 来添加本地代码相关联的远程仓库，执行该命令后以后git push推送时就不用指明推送的地址了。
（3）git add . 添加文件，.代表添加所以文件，如果不想添加所有文件，使用.gitignore来限制。
（4）git commit 提交到本地仓库
（5）git push origin master 推送到远程仓库,origin是远程仓库的分支，master是本地仓库的分支，根据实际情况进行更改即可。
二、本地有代码，远程仓库也有一些代码
如上面情形中创建仓库时误选了Initialize this repository with a README导致生成README.md文件。这时执行上面情形的git push命令时会遭到拒绝。因此，执行命令会有所区别，可以在git push 时使用git push origin master –force来强制或者使用下面的过程。
右键 本地代码文件夹来执行下面命令
（1）git init 初始化
（2） git remote add origin git@github.com:yourName/yourRepo.git 来添加本地代码相关联的远程仓库，执行该命令后以后git push推送时就不用指明推送的地址了。
（3）git pull origin master 拉取远程仓库的代码，origin为远程仓库分支，master为本地仓库分支。拉取后由于本地中也有代码，如果两边都有相同的文件名导致冲突，因此必须修改冲突，即将有冲突的文件进行修改。
（4）修改完有冲突的文件后，git add . 来添加文件
（5）git commit 提交
（6）git push origin master 推送到远程仓库,origin是远程仓库的分支，master是本地仓库的分支，根据实际情况进行更改即可。
三、从其他电脑上拷贝的代码文件夹（当然包含其中的.git目录）
可以直接使用
参考文章
1、github简单使用教程 http://wuyuans.com/2012/05/github-simple-tutorial/
2、github入门教程：第一步 http://www.wojilu.com/Forum1/Topic/1637
转载请注明：jinglingshu的博客 » 命令行下github使用