《GitHub 入门与实践》 笔记
了解GitHub
Git 和 GitHub 的区别
在Git中，开发者将源代码存入名为“Git仓库”的资料库中，并加以使用。而GitHub则是在网络上提供Git仓库的一项服务。这也就是说Github上公开的软件源代码都是有Git进行管理。
社会化编程
SOCIAL CODING.随着GitHub的出现,让所有人都平等的拥有了更改源代码的权利,软件开发者们才真正意义上拥有了源代码.
Git 操作
Git 基本操作
- git init ——初始化仓库
- git status ——查看仓库状态
- git add ——向暂存区添加文件
- git commit ——保存仓库的历史记录,.可以将当前暂存区中的文件实际保存到仓库的历史记录中.通过这些记录,我们可以在工作树中复原文件
- -m参数:参数后为提交信息的概述(单行)
如果想要记述得更加详细,不加-m,执行后编辑器会启动，格式如下
第一行:用一行文字简述提交的更改内容 第二行:空行 第三行以后:记述更改的原因和详细内容
- git log —— 查看提交日志
- 只显示提交信息的第一行 git log –pretty=short
- 只显示指定目录/文件的日志 git log README.md
- 显示文件前后的改动 git log -p README.md
- git diff —— 查看更改前后的差别
- 查看工作树和暂存区的差别 git diff
- 查看工作树和最新提交的差别 git diff HEAD.(不妨养成这样一个好习惯：在执行git commit前，执行git diff HEAD命令，查看本次提交和上次提交的差别，确认后再提交）
其他常用操作
#（项目在github上）直接clone 远程仓库
git clone git@github.com:michaelliao/gitskills.git
#（本地已有项目）上传本地文件到远程仓库
git init
git remote add origin git@xxxx.git
git add .
git commit -m 'something'
git push origin master
git status
#可以丢弃工作区的修改 (commit 之前
git checkout -- file
#把暂存区的修改撤销掉（unstage），重新放回工作区
git reset HEAD file
#从远程仓库更新最新代码
git pull origin master
#清除提交缓存，然后可以重新添加
git rm -r --cached . /或者指定文件 分支操作
#创建新分支，并且切换到新分支
git checkout -b dev
# 查看当前分支
git branch
# 提交到当前分支
git push origin dev
# 合并到主分支,先切换到 主分支,再merge
git checkout master
git merge dev
#合并后，还需要再push一次
git push origin master
#删除分支
git branch -d dev
git push origin :devtag 操作
git tag -a v1.0 -m 'some message'
git show v1.0
git push origin v1.0
# 删除 tag
git tag
git tag -d v1.1
git push origin --delete tag v1.1Git： 分支操作
- git branch —— 显示分支一览表
- git checkout -b —— 创建、切换分支
创建分支，并切换到分支，并提交
$ git checkout -b feature-A Switched to a new branch 'feature-A' //实际上等同于下面两条命令 $ git branch feature-A $ git checkout feature-A- 切回到master， git checkout master
切回到上一个分支，git checkout – , 用”-” 可以代替分支名
- 特性分支：是集中实现单一特性（主题），初次之外不进行任何作业的分支。
- 主干分支：可以发布软件的稳定分支。有时可以用标签Tag等创建版本信息，同时管理多个版本的发布。
- git merge ——合并分支
假设 feature-A 已经开发完，先需要将它合并到master。
$ git checkout master $ git merge --no--ff feature-A // 为了在历史记录中明确记录本次分支合并，我们需要创建合并提交。因此需要加上 --no--ff 参数
- git log –graph —— 以图表的形式查看分支。*该命令可以用图表形式输出提交日志，非常直观
更改提交的操作
- git reset ——回溯历史版本
- 要让仓库的HEAD、暂存区、当前工作树回溯到指定状态，需要用到git reset –head 命令。只需要提供hash值，就可以完全恢复至该时间点的状态
- git log 只能查看当前状态为终点的历史日志。用git reflog 可以查看当前仓库的操作日志。通过log查找hash值，通过reset –hard 命令恢复到回溯历史前的状态
- 消除冲突
解决冲突后，执行git add 和git commit命令
<<<<<<< HEAD -feature-A ======= -fix-B >>>>>>> fix-B
- git commit –amend ——修改提交的comment （上一条），执行命令后，会启动编辑器。执行 git log –graph 可以查看是否修改成功。
- git rebase -i —— 压缩历史日志。
git rebase -i HEAD~2 : 可以选定当前分支中包含HEAD（最新提交）在内的两个最新历史记录对象，并在编辑器中打开
pick 7a33333 Add feature-C pick 6f11111 Fix typo #p,pick = use commit #r,reword = use commit,but edit the commit message #e,edit = use commit,but stop for emending #s,squash = use commit, but meld into previous commit #f,fixup = like 'squash',but discard this commit`s log message #x,exec = run command (the rest of the line) using shell //将6f11111 Fix typo的历史记录，压缩到7a33333的Add feature-C里。将pick删除，改写为fixup pick 7a33333 Add feature-C fixup 6f11111 Fix typo
远程仓库操作
git remote add ——添加远程仓库
$ git remote add origin git@github.com:github-book/git-tutorial.gitgit push —— 推送至远程仓库
- git clone —— 获取远程仓库
- 执行clone 命令后，默认处于master分支
- git check -b feature -D origin/feature-D
git pull —— 获取最新的远程仓库分支
如果两人同时修改了统一部分源代码，push时就很容易发生冲突。所以多名开发者在同一个分支中进行作业时，为减少冲突情况发生，建议频繁地进行push和pull操作
GITHUB 特殊技巧
搜索文件
在仓库页面按 ‘t’键，然后输入要找的目录或者文件的部分名称，筛选器会在仓库目录和文件中进行筛选，搜索出要找的文件。这种方式比一级级查看目录和文件要快得多。
查看差别
在github上，直接修改URL就可以让用户以多种形式查看差别。
查看分支之间的差异
https://github.com/rails/rails/compare/4-0-stable...5-0-stable这样就可以查看两个分支之间的差异了。上面的网页可以看到，两个版本之间提交有上万次，Files changed 有3315….
查看与几天前的差别
https://github.com/rails/rails/compare/master@{7.day.ago}...master这样就可以查看这段期间内的差别。day 还有其他几种形式。
- day
- week
- month
- year
查看与指定日期之间的差异
https://github.com/rails/rails/compare/master@{2016-09-01}...master这样便可以查看与指定日期之间的差别。
由于可以从多种角度查看差别，所以github也称得上是一款优秀的源代码查看器。善于利用上述技巧，能节省不少时间。
GMF 语法特殊用法
GMF github-flavored-markdown.MD语法不做过多介绍，只介绍其中一些特性。
语法高亮
def hello_world
puts 'hello world'
end这样一来，代码就会被添加语法高亮，变得直观易读。
TaskList 语法
//本月计划的任务
- [ ] 完成ES6语法改造
- [ ] 完成非正常单词改造
- [x] 学完GITHUB特殊技巧- [ ] 完成ES6语法改造
- [ ] 完成非正常单词改造
- [x] 学完GITHUB特殊技巧
这样一来 ，这段文字就会标记成复选列表的样式。这个复选样式可以直接勾选或者取消。不必打开编辑器重新编辑，非常方便
在评论中应用表情
在评论中输入 “:” 便会启动表情自动补全功能。只需要输入几个与表情相关的字母，系统就会为您筛选自动补全的对象。具体表情见：http://www.emoji-cheat-sheet.com
Issue 技巧
在相关Issue中显示提交信息
在Issue一览表中，可以看到，每个Issue的标题下面都带了诸如 “#21” 的编号。这样只要在提交信息时，带上 “#21” 就可以在Issue中看到该提交信息，使关联的提交一幕了然
Close Issue
在提交信息中以下列任一一种格式描述提交信息，对应的Issure就会被close。
- fix #21
- fixes #21
- fixed #21
- close #21
- closes #21
- closed #21
- resolve #21
- resolves #21
- resolved #21
利用该方式，每次提交并且push后，就不必大费周章到GitHub的Issue中寻找相应的Issue 再手动Close。
GitHub 的其他功能
GitHub Pages
Github pages 主要用于在Github上托管静态HTML，以便发布项目的Web页。
由于可以绑定独立的域名，人们也经常利用结合这个功能的Octopress 来搭建博客
Github Jobs
面向全世界招聘程序员的职位公告板。Jobs
Github Enterprise
企业版
Github API
GitHub 面向开发者公开了API。 具体见 https://developer.github.com
Pull Request
按部就班地创建GitHub账号并公开自己的源码并不是什么难事。Pull Request 是社会化编程的象征，可以说给开源开发世界带来了一场革命。不会用这个功能，就等于不会用GitHub。。。（作者吹得有点过。。）
Pull Request 是GitHub的核心功能
Conversation
（以下技巧同样可以应用在其他评论中，如Issue）
在评论中应用表情
（同样应用在其他评论中，如Issue）在评论中输入 “:” 便会启动表情自动补全功能。只需要输入几个与表情相关的字母，系统就会为您筛选自动补全的对象。具体表情见：http://www.emoji-cheat-sheet.com
引用评论
只要选中需要引用的语句，然后按“R键”便会自动以引用的形式添加到评论栏，这样一来就可以轻松便捷地引用评论了
让Pull Request 更加有效的方法
在开发过程中发送Pull Request进行讨论
避免一个功能在开发完成后才收到来自设计或者实现方面的指正，导致代码需要大幅更改或者重新实现
明确标出 “正在开发过程中”
为了防止开发到一半的Pull Request 被合并，一般在标题前加上 “[WIP]” 字样，WIP 是 Work In Progress的简称
不进行Fork 直接从分支发送Pull Request
一般来说，在Github上修改对方的代码时，需要先将仓库Fork到本地，然后再修改代码，发送Pull Request。
但是，如果用户对该仓库有编辑权限，则可以直接创建分支，从分支发送 Pull Request
