一步步讲解如何开源自己的项目到GitHub上，Mac机示例

如果你有自己的优秀项目，想要分享给大家，那GitHub会是你正确的选择。如何才能将自己的项目上传到GitHub上呢？接下来请一步一步跟着走。

需要准备的资源：

　　　　1.一台Mac机

　　　　2.安装git客户端（下载地址：http://code.google.com/p/git-osx-installer/downloads/list?can=3），下载好直接安装就好。

　　　　3.一个GitHub账户（注册地址：https://github.com/join?source=header-home）

　　　　4.一个电子词典（如果是英文水平不错的小伙伴，就不需要了，因为注册流程为全英的，其他操作也是英文的）

　　　　5.你的项目

准备好上面的以后就可以开始了。

一.创建属于你的SSH。SSH是Secure Shell的缩写，意为安全外壳协议，具体内容请百度搜索“SSH”。创建步骤如下：

1.1在GitHub网站登录后，找到下图所示的按钮，选择“Settings”

1.2接下来你会看到下图，选择“SSH and GPG keys”

1.3接下来就可以新建你的SSH keys，找到下图中所示的按钮“New SSH keys”

问题来了

这两个框框里填什么呢？

不要着急，下面的代码框里的东西会告诉你里面应该填什么，不过这里我们可能要岔开一会，讲一讲这两个框里的东西从哪来？不要着急，很短，不要跑神儿哦！不过我会提醒你再回到正轨上的。

打开终端

黑题是要手动输入的，“/**/”里时提示语，告诉你那里是干嘛用的
$ssh-keygen -t rsa -C xxxxx@gmail.com   /*注册github时的email*/
        Generating public/private rsa key pair.
        Enter file in which to save the key (/Users/.../.ssh/id_rsa): /*此处光标会停下来，等待你的输入，不用输入，直接回车“enter／return”*/
        Created directory '/Users/.../.ssh'.
        Enter passphrase (empty for no passphrase): /*此处是让你设置你SSH的密码，不输的话，默认没有密码*/
        Enter same passphrase again: /*重新输入密码，用来验证*/
        Your identification has been saved in /Users/.../.ssh/id_rsa.
        Your public key has been saved in /Users/.../.ssh/id_rsa.pub.
        The key fingerprint is:
        18:16:11:c9:01:6c:48:09:7f:27:c6:43:0d:7f:3f:84 xxxxx@gmail.com
        The key's randomart image is:
        +--[ RSA 2048]----+
        |.o.++===         |
        |.ooo.+. .       |
        |  ..* = E .      |
        |   o = + o       |
        |      . S o      |
        |           .     |
        |                 |
        |                 |
        |                 |
       +-----------------+

接下来请打开上面显示的路径（打开文件管理器，commend＋shift＋g，将路径粘贴进去回车），你就可以看到两个文件“id_rsa”和“id_rsa.pub”，使用文本编辑器打开“id_rsa.pub”将其中的内容全部复制。

好了放松一下，回到正轨上啦！且回到刚刚的网页，首先在“Title”下的文本框中输入你的注册邮箱，在“Key”下的文本框中粘贴刚刚复制的东西，点击带有“Add SSH key”字样的绿色按钮，就大功告成了。

二.创建完自己的SSH后，请创建你的项目的profile。

2.1还记得刚刚GitHub网站停留在哪一页吗？对，是设置SSH keys那一页，现在，在这一页找到下图所示的按钮，点击“New repository”

2.2你会看到

2.3接下来是要填入信息的解释：Repository name －>你项目的名称；Description－>你项目的简单描述；下面的单选决定该项目是公有还是私有，公有时所有人都可以看，私有时可以选择给谁看；下面的复选框决定是否将你的项目介绍写入“README.md”文件。接下来点击“Create repository”即可。

三.好了，上传项目的工作已经接近尾声，坚持住，往下看。

3.1打开终端，输入以下命令

cd ~/.ssh

如果上面的步骤都没问题，此时你应该会进入该路径。下面将会发生神奇的事，在终端中即可完成代码的上传工作。

上传前请确保终端已经连接到GitHub，输入以下命令测试

ssh -T git@github.com

连接成功的返回应该是

Hi "your name"! You've successfully authenticated, but GitHub does not provide shell access.

3.2以此键入以下命令

touch README.md //新建一个记录提交操作的文档
git init //初始化本地仓库
git add README.md //添加文件
git commit -m "first commit"//提交到本地仓库，并注释
git remote add origin git@github.com:youname/Test.git //连接远程仓库并建了一个名叫：origin的别名
git push -u origin master //将本地仓库的东西提交到地址是origin的地址，master分支下

上面的代码做了什么？其实它只是讲一个文本文件提交到了“master”分支上，没什么特别的，值得注意的是，里面的“add”，“commit”和“push”三个操作，“add”可以添加多个文件分多行键入，也可添加当前目录下的所有文件“add .”即可，“commit”操作是提交到本地仓库，注意是本地仓库，这一操作不会影响远端的代码；“push”操作则是将本地修改的代码push到远端分支。

3.3最后一步，上传你的项目到GitHub。键入以下命令

首先切换到你项目所在的路径
git init
git add .
git commit -m "first commit"
git remote add origin git@github.com:youname/Test.git
git pull origin master
git push -u origin master 

解释一下，上面现切换到你的项目所在的路径，从而可以使用“add .”命令将项目所有问价都上传到GitHub。

3.4本来到这你应该已经把自己的项目成功上传上去了，但是，也可能会遇见一些问题

例如

To git@github.com:PaulPaulBoBo/ForHealth.git
 ! [rejected]        master -> master (non-fast-forward)
error: failed to push some refs to 'git@github.com:xxx.git'
hint: Updates were rejected because the tip of your current branch is behind
hint: its remote counterpart. Integrate the remote changes (e.g.
hint: 'git pull ...') before pushing again.
hint: See the 'Note about fast-forwards' in 'git push --help' for details.

上面说上传一些“refs”错误，在pushing之前请pull，为什么会这样呢？原因是本地代码跟远端的冲突造成的，应该先将远端的代码拉回到本地再上传。

方法1：

git pull origin master

git push -u origin master

方法2：

git pull --rebase
git push --dry-run --verbose origin HEAD:master
git push origin HEAD:master

这样就可以解决冲突问题了。当然，后期开发的时候，如果冲突问题比较多的话，还得手动修改某些冲突文件后才可以上传。推荐使用SourceTree客户端（下载地址：https://www.sourcetreeapp.com/download/）。

好了，项目上传完毕，你可以跟全世界一起讨论你的项目了！