搬运自本人 CSDN 博客：https://blog.csdn.net/ajianyingxiaoqinghan/article/details/70544159

---

Ubuntu环境如何上传项目到GitHub网站？

之前笔者写了一篇《CMake学习笔记（三）——以笔者的Robosub竞赛为例》的博客。博客中笔者以自己的项目为例，解释整个项目cmake流程，但是当时笔者并没有贴出自己的项目源码。
GitHub 是一个面向开源及私有软件项目的托管平台，注册用户都是来自世界各地的大神级别人物。笔者作为小渣渣也想在里面学习学习，所以就把项目源码托管在GitHub上吧～
由于写这篇博客时，笔者已经申请了账号，且已经上传了几个项目尝试。所以博客中也许会有某些操作略过，但笔者会给出其他参考链接。

笔者的工作环境

• 操作系统：Ubuntu 14.04 LTS 64位

一. 注册账号

首先进入GitHub的官网，注册GitHub账户。
GitHub官网网址：https://github.com/

笔者已经注册了一个GitHub账号，且注册流程十分简单，所以不再赘述。笔者的GitHub主界面如下所示：

GitHub主界面

二. 设置SSH Key

由于本地的Git仓库与GitHub网站仓库之间的传输是通过SSH加密的，所以这时候需要设置SSH keys。
笔者本来有两个SSH Keys，但为了写博客就把它删了，准备再重新设置一个SSH Key。
设置SSH Key的参考网址：
http://www.liaoxuefeng.com/wiki/0013739516305929606dd18361248578c67b8067c8c017b000/001374385852170d9c7adf13c30429b9660d0eb689dd43a000

1. 创建SSH Key

首先我们在用户主目录下看是否存在.ssh目录。以笔者为例，笔者使用的是Ubuntu系统，当前用户的主目录是<code>/home/grq</code>，所以此时我们需要查找路径<code>/home/grq/.ssh</code>是否存在。
如果存在，查看是否存在<code>id_rsa</code>与<code>id_rsa.pub</code>两个文件是否存在。如果也存在，就可以调到下一步；
如果不存在，便打开终端，输入自己的邮箱地址，创建SSH Key。

ssh-keygen -t rsa -C "youremail@example.com"

其中，"youremail@example.com"是你的邮件地址，<code>-C</code>的字母为大写。后面可以一直回车。中间会让你输入密码，但整个SSH Key对笔者来说保密意义不大，所以不需要设置。SSH Key创建成功后，在笔者的主目录下就会生成<code>/home/grq/.ssh</code>文件夹，里面也会生成文件<code>id_rsa</code>与<code>id_rsa.pub</code>，它们是SSH Key的秘钥对。其中<code>id_rsa</code>是私钥，不能泄露，<code>id_rsa.pub</code>是公钥，可以告诉其他人。
终端设置完成后的界面如图所示：

终端设置完成

2. 在GitHub端设置SSH Key

登录GitHub，点击右上角头像，Settings -> Personal settings -> SSH and GPG keys。在SSH Keys标签右方点击New SSH Key。
弹出两个文本框。其中的Title，可以随意命名。笔者此处随便命名为grq-Ubuntu。
另一个Key文本框，需要输入刚刚生成的<code>id_rsa.pub</code>文件中的内容。粘贴后点击<code>Add SSH Key</code>，即可生成SSH Key。如图所示：

生成 SSH Key

三. 上传项目

笔者查阅资料，有网友得出总结，可以将git分为四部分：一部分是自己的本机文件，一部分是缓存区，一个是本地仓库，一个是服务器仓库。当用户在本机修改了文件后，就应该使用<code>git add xx</code>指令将修改保存到缓存区，然后再用<code>git commit yy</code>指令将推送从缓存区修改到本地仓库中，最后使用<code>git push</code>将本地仓库中的修改推送到服务器仓库中。
下面按照流程讲解。

1. 准备上传

首先，我们需要确定的是Ubuntu中是否安装Git。
打开终端，输入指令<code>git</code>，如果返回了一大串提示信息，那么就已经安装了。
如果没有安装，就输入以下指令：

sudo apt-get install git

安装完毕后，终端进入我们需要上传项目所在的文件夹。使用git的初始化命令：

git init

这个命令可以把当前目录变成git可以管理的仓库。
现在我们就可以进行git操作将项目上传到GitHub了。

2. 添加需要上传的文件

上传之前，我们需要添加上传的文件。这里使用到的指令是：

git add file

其中，file是我们想要添加的文件。这里笔者想要将整个文件夹内容都添加进去，所以此处笔者输入的指令如下：

git add ./

3. 检查当前git状态

然后我们可以使用git指令，查看当前git的状态。指令如下：

git status

该指令可以查看当前的分支以及添加文件的情况。
由于笔者之前已经上传过该项目，此次属于更新该项目，所以输入该指令后的状态如下图所示：

更新项目，提交变更

现在可知，笔者当前的信息就是在master分支上。

4. commit推送

笔者此处使用指令，将缓存区的修改提交到本地仓库。笔者的指令如下：

git commit -m "Update Readme Files(Version of Chinese & English)"

-m后的内容是笔者添加的描述。由于笔者这次是更新该仓库，更新内容是中文与英文的Readme文件，所以就写了上述的备注。

如果输入commit指令后，出现错误：

** Please tell me who you are.
Run
  git config --global user.email "you@example.com"
  git config --global user.name "Your Name"

to set your account's default identity.
Omit --global to set the identity only in this repository.

fatal: unable to auto-detect email address (got 'XXX@YYY.(none)')

这时候的解决办法是，在进行<code>git add ./</code>操作的路径中，实际上已经生成了一个隐藏的.git文件夹。在该路径下输入指令<code>cd ./.git</code>便进入.git文件夹，使用gedit或vim打开文件config，在文件末尾加入内容：

[user]
 email = your email
 name = your name

里面的your email, your name随便填上就行，笔者是直接填的GitHub账号中的Email和用户名。填好后如图所示：

config 文件

这时候再进行commit指令，应该就可以成功了。完成后就可以等待提交了。

5. 添加文件到远程库

上传文件到仓库之前，我们需要拥有一个仓库。由于笔者这里已经构建了仓库，所以只给出在自己的GitHub账号下构建仓库的教程链接如下：
http://www.cnblogs.com/keZhenxu94/p/5288488.html
构建仓库结束后，我们需要得到该仓库的SSH Key才能向其中上传内容。进入刚才新建的仓库，点击Clone or download，在弹出的Clone with SSH框中点击小按钮Copy to clipboard。如下图所示：

Clone with SSH

首先我们应该添加一个远程仓库，命名为origin，这样随后才可以添加文件到远程库中。指令如下：

git remote add origin git@github.com:upcAutoLang/Framework-for-NACIT2017.git

如果此时出现错误：fatal: remote origin already exists. 这时候说明远程仓库已经存在。这时候需要先删除origin仓库，然后再重新添加该远程仓库。指令如下：

git remote rm origin
git remote add origin git@github.com:upcAutoLang/Framework-for-NACIT2017.git

这时候应该就应该不会报错了。然后我们添加文件到远程库。笔者使用的指令如下：

git remote set-url origin git@github.com:upcAutoLang/Framework-for-NACIT2017.git

其中，<code>git@github.com:upcAutoLang/Framework-for-NACIT2017.git</code>即为笔者在github服务器仓库中复制的内容。
然后，笔者使用push指令进行上传。如果该仓库是第一次进行push，则指令如下：

git push origin master

但笔者之前已经传输过，此处只是更新，所以只需输入：

git push

之后会弹出问题，询问是否继续？输入yes回车即可。如图所示：

弹出询问问题

push结束后，在GitHub端的对应仓库上刷新一下，内容就改变了。说明项目内容已经上传成功了～

项目内容上传成功

6. 某些push错误的情况

有时候对新建的仓库进行push操作，会出现上传失败的情况。
通常出现这种情况的原因，是新建的仓库往往会有一个文件Readme.md文件，而本地仓库中没有这个文件，也就是说本地仓库与服务器端仓库没有实现同步。所以将这个Readme.md文件clone到本地，然后再commit提交，应该就没有问题了。

或者在 push 操作的时候遇到下述错误：
<code>error: 无法推送一些引用到 'git@github.com:upcAutoLang/BackgroundSplit-OpenCV.git'
提示：更新被拒绝，因为远程仓库包含您本地尚不存在的提交。这通常是因为另外
提示：一个仓库已向该引用进行了推送。再次推送前，您可能需要先整合远程变更
提示：（如 'git pull ...'）。
提示：详见 'git push --help' 中的 'Note about fast-forwards' 小节。
</code>
出现该情况的原因可能是之前在上传时创建的.git文件被删除或者修改，也可能是其他人在 Github 上提交过代码。

解决方案：
1. 强行上传：

git push -u origin +master

2. 尽量先同步 Github 上的代码到本地，在上面更改之后再上传。