如果你有自己的优秀项目,想要分享给大家,那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 [email protected] /*注册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 [email protected] 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 [email protected]
连接成功的返回应该是
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 [email protected]: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 [email protected]:youname/Test.git git push -u origin master
解释一下,上面现切换到你的项目所在的路径,从而可以使用“add .”命令将项目所有问价都上传到GitHub。
3.4本来到这你应该已经把自己的项目成功上传上去了,但是,也可能会遇见一些问题
例如
To [email protected]:PaulPaulBoBo/ForHealth.git ! [rejected] master -> master (non-fast-forward) error: failed to push some refs to ‘[email protected]: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,为什么会这样呢?原因是本地代码跟远端的冲突造成的,应该先将远端的代码拉回到本地再上传。
git pull --rebase git push --dry-run --verbose origin HEAD:master git push origin HEAD:master
这样就可以解决冲突问题了。当然,后期开发的时候,如果冲突问题比较多的话,还得手动修改某些冲突文件后才可以上传。推荐使用SourceTree客户端(下载地址:https://www.sourcetreeapp.com/download/)。
好了,项目上传完毕,你可以跟全世界一起讨论你的项目了!