四步搞定mac github客户端 & readme.md插入gif

---

github到底是干嘛的，有什么作用，我想只要是看到这个标题进来的你，应该都知道一二，也许你只是一时兴起误闯的，也没关系，google或百度github，你就会懂的，这里就不做赘述了。GitHub Desktop官方下载链接

其实，网上关于mac github桌面客户端使用还是有些资料的，只是自己亲身去实践一遍，发现还是有些要补充的，就写下这么个总结，方便自己以后查阅，也希望能帮到遇到同样问题的你。

简单四步搞定：

• 创建github账号
• 提交本地项目到github上，并更新同步提交代码
• clone github服务器上的项目到本地
• 创建项目分支，并将改动合并到主支

---

一，创建github账号

要想让github帮我们托管项目，首先肯定是要有一个github账号的，点击注册github账号

点击sign up根据提示一步一步填写注册即可

---

二，提交本地项目到github上，并更新同步提交代码

• 下载安装完了GitHub Desktop之后，界面大概是这样的，自带的指导手册已被删，但是界面差不多。

• 把本地项目加入到github本地仓库，并提交到github上。（注意图片下的说明）

这里你也可以选Create，好了之后把需要上传的项目拷贝到该路径下就行

点击Create&Add Repository之后如此图

• 至此，你已成功将本地项目上传到了github上，是不是很简单。提交更新也是一样的，细心的你应该也发现了本地项目有任何改动的话，在github desktop里面都会相应的提示，之后你要提交哪个文件就选中哪个文件，记得写上简要和详细注释，之后commit就ok了。

---

三，Clone github服务器上的项目到本地

对程序员来说，估计没有人不喜欢github的，因为github上实在是有太多的很好的开源库和实用的demo，比如说AFNetworking，MJExtension等。这时候你就会用到clone，当然你可以下载下来，只是假如有更新的话，你又要重新下载，好麻烦。如果选择clone的话，只需要同步下就行。

• clone github服务器上别人的项目

• clone github上自己的项目

---

四，创建项目分支，并将改动合并到主支

• 创建分支

• 把代码提交到分支上

• Pull Request，合并

---

问题小结：

• 上传本地项目到github上的时候，出现如下错误

解决方法：删掉github服务器上的资源库，先不要把内容commit，只是publish空资源库，之后再commit 同步，就行了。 如果还是不行可能是你提交的内容太多，网速有不好导致的，可以分批次commit。（我就遇到过，因为提交了个gif文件，一起提交就报这个错误，分批次提交就好了）

---

README.md插入png图片

• 将图片上传到github上

1 上传成功，刷新浏览器，能查看到图片文件夹

• 获取图片相对路径

2 点击copy path拿到图片相对路径

• 在README.md中输入图片绝对路径

特别注意： 正确：https://github.com/用户名/资源库名称/raw/master/screenshots/screenshot1.png 而不是：https://github.com/用户名/刚才copy的相对路径 网上有的说是这样，其实这样图片是显示不出来的

3 README.md文件插入图片语法，类似markdown语法

---

README.md插入gif图片

github上好多demo都配有gif动态图，对短时间了解demo非常有帮助且比较清晰，果断就网上搜了下。最后，发现其实跟上面插入图片用法是一样的。只是这个动态图的格式要注意，不能是MP4，要为gif才行。
Tip：最新qq自带录屏功能（control+cmd+a，默认是截屏，选择录屏），得到gif动态图（结束录屏之后不要选择绿色的勾，而是要选择旁边的另存为，里面有保存格式选择，记得选gif），并上传到github上（操作同之前插入图片）

---

设置sshkey

• 拷贝公匙
  1、得到公匙，打开终端输入如下命令，
  ssh-keygen -t rsa -C "[email protected]"
  会让你输入文件存放位置和密码，也可以忽略直接enter。
  2、复制id_rsa.pub文件内容
  下面两种方法都可以
  方法一：用cat命令打开pub文件，之后选中显示的内容复制（直接双击系统是打不开该文件的，注意pub文件路径，我的是在/Users/admin/.ssh/下面的，具体的可以自己查找下）
  cat /Users/admin/.ssh/id_rsa.pub
  方法二：执行如下命令之后，直接黏贴到github服务器上，保存就好
  pbcopy < ~/.ssh/id_rsa.pub
• github上，cmd+v黏贴公匙

• 激活公匙
  ssh -T [email protected]
  新添加到github上的秘钥左边的点一开始是灰色的，终端执行这个命令后，刷新网页会看到灰色点变成了绿色.

上的这篇文章写的也很详细

git常用命令这个网页已总结的很好，直接拿来用，就不写了