《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 :dev
tag 操作
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.1
Git: 分支操作
-
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.git
-
git 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