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