git 基本使用教程

转自：http://www.lsychina.com/usage_of_git_and_github.html

GitHub 是一个类似 SourceForge 的免费项目管理及分享的服务平台，要想使用 github，用户可以免费注册成为 github 注册用户，之后使用git命令进行操作使用。github 的网址是：github.com。

一、建立 github 仓库

在 Github 创建账号后，点击 New Repository，填写一些本仓库相关的信息，如仓库名称、描述、是否公开。设置完毕后，点击 Create repository 即可创建新仓库。如，建立testproject。

二、建立本地 git 仓库

接下来是使用 git 这个软件命令进行操作和使用了，首先，我们当然需要安装 git

git 的配置文件为 ~/.gitconfig (单个用户) 或 /etc/gitconfig (系统全局)。以在 Linux 下操作为例，执行以下命令：

$ git config --global user.name "lsychina" #该昵称显示在提交时使用 
$ git config --global user.email xxx@gmail.com #该邮箱提交时使用 
#在上述设置完毕后，可通过下面这两条命令查看自己的设置： 
$ git config user.name $ git config user.email 
$ mkdir ~/testproject #此处testproject替换成实际的仓库/项目名，目录创建在别处也可以 
$ cd ~/testproject #切换至刚刚创建好的目录 
$ git init #初始化git仓库
$ touch README.txt #创建README.txt文本文件，但该文件尚未添加到版本库，可以修改该文件的内容 
$ git add README.txt #将README.txt文件加入到本地版本库 
$ git commit -m "commit README.txt" #将文件提交到本地版本库 
$ git log #查看提交日志

三、将本地项目提交到 GitHub 仓库

上述一系列操作，我们只是在本地建立了一个 Git 版本库，下面我们将本地的项目推送到远程服务器(Github 仓库)。完成下述操作后，人们就可以在 Github 页面上看到我们提交的文件了。

#注：以下这两条命令会在你第一步创建好 github 仓库后，由 github 提供给你 $ git remote add origin https://github.com/用户名/仓库名.git #使用https协议连接，添加远程仓库 $ git push -u origin master #推送到Github test仓库主枝，一般默认为 master

执行上面第二条命令时，git 可能返回以下错误信息：

error: The requested URL returned error: 403 Forbidden while accessing https://github.com/XXX/YYY.git/info/refs

fatal: HTTP request failed

那么，我们可以换用ssh协议连接，方法如下：

1. 创建SSH密钥

$ ssh-keygen -C 'Email地址' -t rsa

2. 找到刚才生成的密钥 (默认为~/.ssh/id_rsa.pub) 文件打开，然后复制里面的内容。接着转到 github 站点，进入 Account Setting –> SSH Keys 选项后，点击 add SSH key 并将刚才复制的内容粘贴保存。

3. 测试SSH连接。

$ ssh -v git@github.com

如果出现类似以下内容的提示，则证明SSH连接工作正常了：

Hi loosky! You’ve successfully authenticated, but GitHub does not provide shell access.

4. 再次尝试推送

$ git remote rm origin #删除之前的添加信息 (配置文件在 ~/testproject/.git/config) 
$ git remote add origin git@github.com:用户名/仓库名.git #使用ssh协议连接，添加远程仓库 (此条命令由github提供) 
$ git push -u origin master #再尝试推送到Github test仓库主枝，一般默认为 master