@ValenW 2016-05-05T14:13:30.000000Z 字数 6081 阅读 1726

Git简易教程

博客 作业 教程

Linus在1991年创建了开源的Linux，由于有众多网友贡献代码，管理代码成为了一个问题。在2005年，Linus花了两周时间自己用C写了一个分布式版本控制系统，这就是Git。Git迅速成为最流行的分布式版本控制系统，在2008年，GitHub网站上线，为开源项目免费提供Git存储。

git是一个分布式版本控制软件，最初由林纳斯·托瓦兹（Linus Torvalds）创作，于2005年以GPL发布。而GitHub是一个利用Git进行版本控制、专门用于存放软件代码与内容的共享虚拟主机服务。它由GitHub公司（曾称Logical Awesome）的开发者Chris Wanstrath、PJ Hyett和Tom Preston-Werner使用Ruby on Rails编写而成。

集中式版本控制和分布式版本控制？

主要在于工作时是否需要保证当前的代码版本为最新版，这需要一台中心服务器，并且工作中的每台电脑都必须要联网。而分布式则没有这些要求，每个人都会有一份完整的代码仓库的拷贝，离线工作完成后，只要交换各自的更改，处理冲突，达成一致后就能有一份最新的版本。具体参考廖老师的教程

版本库控制

版本库是记录文件或目录状态的地方，存储着内容修改的历史记录。可以简单理解成一个目录，这个目录下所有文件都可以被Git管理起来，每个文件的修改、删除，Git都能跟踪，以便任何时刻都可以追踪历史，或者在将来某个时刻可以“还原”。

创建

在本地创建一个空版本库:

$ cd dir/of/repository
$ git init

克隆本地版本库：

$ cd father/dir/of/repository
$ git clone /path/to/repository

克隆远程版本库：

$ cd father/dir/of/repository
$ git clone /path/to/the/remote/repository

或者

$ git clone git@github.com:username/repo-name.git

比如:

$ cd ~
$ git clone https://github.com/ValenW/AQL-Subset
$ cd AQL-Subset

提交变动到版本库

git的本地仓库通过维护.git文件夹里的版本库记录来维护版本库。其中有称为stage的暂存区，自动创建的master分支和指向当前版本的HEAD指针。
添加文件改动到版本库需要分两步，add和commit。add指令将所要提交的修改放到暂存区(stage)，可以多次add，而commit指令将缓存区中所有变动一次性提交到版本库中。

add

编辑好文件，比如new_file.txt, 之后将文件放入到版本库目录下，然后$ git add new_file.txt即可。
若要把版本目录下所有文件都加入到版本库，则只需$ git add *即可

commit

$ git commit -m "message about this commit"其中-m后面输入这次提交的详细说明。
这样就完成了一次代码库的变动提交

rm

$ git rm filename会将filename删除，并提交该修改到缓存区，之后可用过$ git commit来提交这次删除操作。

查看当前代码库状况

$ git status命令会显示当前代码库的状况，包括添加，修改（modified），删除（deleted）
$ git diff filename命令可以查看某个文件的具体内容变动，格式是标准的Unix通用diff格式

查看提交的历史记录

使用命令$ git log
如果信息太多，可以在一行内展示一次提交：$ git log --pretty=online
更多格式化可参考这篇文章，一个丧心病狂的命令就是git log --graph --pretty=format:'%Cred%h%Creset -%C(yellow)%d%Creset %s %Cgreen(%cr)%Creset' --abbrev-commit --date=relative

版本管理

指向git当前最新版本为HEAD，HEAD^表示上一版本，HEAD^^上上一个版本，HEAD~100表示往上100个版本

版本标签

可以对某次提交打上如v0.3之类的标签。
git tag <tag-name> <branch-id>对branch-id对应的分支打上标签，如空则默认为当前分支打上标签。
git tag -a <tag-name> -m "tag-massage"可以指定标签名和对应信息。
之后可通过git show <tag-anme>获取具体信息。
git tag -d <tag-name>删除对应标签。

提交标签到远程仓库

git push origin <tag-name>推送tag-name到远程仓库
git push origin --tags推送所有未推送的tag到远程仓库
git push origin :refs/tags/<tag-name>删除远程标签，之前必须删除本地对应标签。

版本回退

要回退到某一版本时，比如上一版本，只需$ git reset --hard HEAD^
那回退后后悔了，要回退到更新的版本呢？可以通过commit id或者标签来标识某一版本:

$ git reset --hard commit_id

commit id可以在git log命令中找到，只需输入前几位，保证唯一就可以了，不必写全。
而git reflog则会把reset也作为一次更新，这样就可以找到所有版本的id了。

缓存区回退

$ git reset HEAD filename命令可以将缓存区中的所有修改撤销掉，并将修改放回工作区中，如此时工作区原本有修改，则会被覆盖。

工作区回退

git checkout -- filename可以撤销工作区中filename的修改，将其回退到最近一次git commit或git add时的状态

撤销总结

修改后未add（添加到暂存区）
- git checkout -- myfile.txt 或手动删除工作区修改
- 工作区： clean 暂存区： clean
修改后 add了（未commit）再次修改文件要撤销第二次修改时：
- git checkout -- myfile.txt (将暂存区恢复到工作区)
- 暂存区有第一次的修改需要commit
修改后 add了（未commit），需要撤销修改时：
- git reset HEAD myfile.txt (将暂存区修改删除)
- 此时工作区的修改还未撤销
- git checkout -- myfile.txt (撤销工作区修改)
修改后 add并commit了，需要撤销修改时：
- git reset --hard HEAD^ (版本回退)

远程版本库控制，以github为例

关联用户主机和Github账号

创建用户的SSH Key(在shell或git bash内）:
$ ssh-keygen -t rsa -C "email@you.com"
在github上添加SSH Key Github添加SSH Key

将本地仓库关联到远程仓库

在本地仓库的目录下
$ git remote add origin git@github.com:username/repo-name.git
第一次提交：
$ git push -u origin master
以后：
$ git push origin master

分支管理

创建分支

$ git checkout -b br-name
相当于

$ git branch br-name
$ git checkout br-name

$ git branch会显示出所有分支，当前分支前会有*标记

合并分支

$ git merge br-name将br-name分支合并到当前分支下
加入--no-ff则表示禁用Fast forward模式。即新建commit而不是切换HEAD指针来实现
$ git merge --no-ff -m "merge with no-ff" dev
合并分支前可以通过git diff <source_branch> <target_branch>来查看两者不同

删除分支

$ git branch -d br-name

冲突解决

merge分支时，如果两分支对同一地方做了不同的修改，则为冲突，冲突的文件git会生成如下内容

<<<<<<< HEAD
Creating a new branch is quick & simple.
=======
Creating a new branch is quick AND simple.
>>>>>>> feature1

则直接在产生的文件中修改，然后add，commmit即可

git log --graph可以看到分支合并图

bug修复，临时分支

需要修复bug，但当前任务没完成，可以用stash来存储现场。

保存

git stash保存当前工作现场，之后就可以放心转去bug分支修复bug，之后再回来。git stash list命令可以看到当前的stash列表。

恢复

git stash apply可以恢复最近一次的现场，但恢复后不删除stash list中的stash，之后需要使用git stash drop来手动删除。
也可以直接git stash pop来恢复同时删除现场。
更详细的可以参考廖雪峰教程

feature分支

同样的做法也可以用于新增feature。增加新功能前先在最新代码上新建一个分支，完成后再和整体代码合并。

多人协作模式

pull和关联本地和远程代码库

首先，需要从github上pull项目代码，然后将本地代码和远程代码关联起来，参考创建版本库和关联本地和远程代码库两章。
可用git remote或git remote -v显示详细信息。
clone后默认只看得到master分支，可用git checkout -b branch-name origin/branch-name来创建和远程分支对应的本地分支。

推送修改

需要推送自己的修改时，用git push origin <branch-name>来推送自己的修改。
如果推送失败，则是因为远程分支比你的本地更新，需要先用git pull试图合并远程和本地的代码。
如果合并有冲突，则解决冲突，并在本地提交。
没有冲突或者解决掉冲突后，再用git push origin <branch name>推送。
如果git pull提示no tracking information，则说明本地分支和远程分支的链接关系没有创建，用命令git branch --set-upstream-to origin/branch-name branch-name进行关联。

github下的协作

先fork仓库到自己账户下，自己完成修改后提出"pull request"，等待对方接受。

其他

.gitignore文件

每一行是一个规则，目录下匹配的文件会被git忽略。可以使用正则表达式语法，Github已经提供了常用环境和语言的范例文件
如果出现add时因为ignore文件而无法添加，则可以使用-f强制添加：$ git add -f a.cpp，如果是ignore规则有问题，则$ git check-ignore -v a.cpp命令可以查看是哪条规则导致无法添加

别名

$ git config --global alias.st status执行后就可以用st代替status了
或者这么用

git config --global alias.lg "log --color --graph --pretty=format:'%Cred%h%Creset -%C(yellow)%d%Creset %s %Cgreen(%cr) %C(bold blue)<%an>%Creset' --abbrev-commit"

然后log界面就成这样了：
log配置界面

其他参考资料

git 教程

Github功能

Issue

基本功能和讨论版一样，有标题和正文，支持Markdown语法。主要用于提出需求，报告bug，讨论实现等等。嗯，也有人用Issue来写博客。

Milestones 里程碑

每个issue可以被包括在某个里程碑上，比如版本更新，alpha，beta版本等等。这样就可以通过里程碑来查找有哪些讨论。

label 标签

每个issue都可以被打上标签，如bug，feature等。github默认有几个标签，当然也可以自定义标签。

@ 提及

在issue中可以用@username来提及某个用户，这样该用户就可以收到提醒。
通常用法是/cc @user1 @user2 /cc表示carbon copy，副本。

references 涉及

在issue正文中可以通过#issueId来提及某个特定的issue，表示这个讨论和提及的讨论有关。
并且，在commit代码的时候，在提交说明中也可以用#issueId提及某个issue，如果检测到说明中含有“Fixes”, “Fixed”, “Fix”, “Closes”, “Closed”, “Close”关键字，则对应issue会被关闭。

详细可参考官方文档：Mastering Issues

wiki

呃就是个写wiki的功能，无法自动生成，全都要自己手写，可以有标题，分页，目录等功能，支持markdown等语法
官方文档：Mastering Wiki

其他链接：
Github Octocat
Github emoji