如何使用Git上传项目代码到GitHub

2015 年 1 月 11 日

这是我第一次应用Git的历程笔记，以下仅供Git初学者参考使用。

GitHub是一个基于Git的代码托管平台，付费用户可以建私人仓库，我们一般的免费用户只能使用公共仓库，也就是代码要公开。这对于一般人来说公共仓库就已经足够了。

1.注册账户以及创建仓库

要想使用GitHub第一步当然是注册GitHub账号了。之后就可以创建仓库了（免费用户只能建公共仓库），Create a New Repository，填好名称后Create，之后会出现一些仓库的配置信息，这也是一个git的简单教程。

2.安装客户端tortoiseGit

GitHub是服务端，要想在自己电脑上使用git我们还需要一个git客户端，我这里选用TortoiseGit，他给我们提供了图形界面的操作。在安装之前首先需要安装git，下载地址http://msysgit.github.com/，TortoiseGit下载地址：http://code.google.com/p/tortoisegit/

装完后右键鼠标会多出一些选项来，在本地仓库里右键选择Git Init Here，会多出来一个.git文件夹，这就表示本地git创建成功。右键Git Bash进入git命令行，为了把本地的仓库传到github，还需要配置ssh key。

3.配置Git

（1）首先在本地创建ssh key；

$ ssh-keygen -t rsa -C “your_email@youremail.com”

后面的your_email@youremail.com改为你的邮箱，之后会要求确认路径和输入密码，我们这使用默认的一路回车就行。成功的话会在~/下生成.ssh文件夹，进去，打开id_rsa.pub，复制里面的key。回到github，进入Account Settings，左边选择SSH Keys，Add SSH Key,title随便填，粘贴key。

（2）为了验证是否成功，在git bash下输入：

$ ssh -T git@github.com

如果是第一次的会提示是否continue，输入yes就会看到：You’ve successfully authenticated, but GitHub does not provide shell access 。这就表示已成功连上github。

如何使用Git上传项目代码到GitHub

（3）接下来我们要做的就是把本地仓库传到github上去，在此之前还需要设置username和email，因为github每次commit都会记录他们。

$ git config –global user.name “your name”

$ git config –global user.name “your name”$ git config –global user.email your_email@youremail.com

（4）进入要上传的仓库，右键git bash，添加远程地址：

$ git remote add origin git@github.com:yourName/yourRepo.git

后面的yourName和yourRepo表示你再github的用户名和刚才新建的仓库，加完之后进入.git，打开config，这里会多出一个remote “origin”内容，这就是刚才添加的远程地址，也可以直接修改config来配置远程地址。

4.提交、上传

（1）接下来在本地仓库里添加一些文件，比如README，

$ git add README

$ git add README$ git commit -m “first commit”

（2）上传到github：

$ 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是这样写的：

bin

.suo

obj

bin和obj是编译目录，里面都不是源代码，忽略；suo文件是vs2010的配置文件，不需要。这样你在git status的时候就只会看到源代码文件了，就可以放心的git add -A了。

GitHub 教程系列文章：

通过GitHub创建个人技术博客图文详解 http://www.linuxidc.com/Linux/2015-02/114121.htm

GitHub 使用教程图文详解 http://www.linuxidc.com/Linux/2014-09/106230.htm

Git 标签管理详解 http://www.linuxidc.com/Linux/2014-09/106231.htm

Git 分支管理详解 http://www.linuxidc.com/Linux/2014-09/106232.htm

Git 远程仓库详解 http://www.linuxidc.com/Linux/2014-09/106233.htm

Git 本地仓库（Repository）详解 http://www.linuxidc.com/Linux/2014-09/106234.htm

Git 服务器搭建与客户端安装 http://www.linuxidc.com/Linux/2014-05/101830.htm