git使用手册（总结）

一、概念

1、工作区：working directory工作目录

2、暂存区：index(stage), 只有被增加到暂存区的修改才会被提交到版本库

3、版本库：仓库(repository)，修改要先添加到暂存区才能被提交

4、 HEAD：指向最后一次提交的结果

 

二、使用

1、创建版本库

#git init

 

2、把文件提交到仓库

第一步：将文件增加到暂存区

#git add file

第二步：将文件提交到仓库

#git commit -m “log info”

 

3、查看仓库状态

#git status

 

4、查看文件具体修改内容

#git diff file

 

5、版本回退

（1）回退到上一个版本： #git reset --hard HEAD^

（2）回退到上上个版本： #git reset --hard HEAD^^

（3）回退到前第n个版本： #git reset --hard HEAD~n

（4）回退到指定版本（根据版本号commit ID）：#git reset --hard “commit ID”

 

6、查看版本日志（内含版本号）

#git log

 

7、查看历史版本号（历史命令）

#git reflog

 

8、撤销修改

【场景一】：修改了工作区某文件内容，还未增加到暂存区

#git checkout -- file

注：撤销工作区的所有修改，即用版本库的版本替换工作区的版本。

这里有两种情况：

一种是file自修改后还没有被放到暂存区，现在，撤销修改就回到和版本库一模一样的状态；

一种是file已经添加到暂存区后，又作了修改，现在，撤销修改就回到添加到暂存区后的状态。

总之，就是让这个文件回到最近一次git commit或git add时的状态。

 

【场景二】：修改增加到了暂存区，这时分两步撤销修改

第一步：从暂存区修改撤回工作区, 这时回到场景一

#git reset HEAD file

第二步：同场景一一样，撤销工作区修改

#git checkout -- file

【场景三】：修改已经被提交到版本库（未推送到远程库），这时就只能版本回退了

#git reset --hard HEAD^

 

9、文件删除（已提交给版本库）

场景：你把工作区的一个文件删除了（#rm file），现在有两种情况：

第一、确实要从版本库删除该文件，那就用git rm将文件从版本库删掉，并用commit提交修改（删除）操作（因为这也相当于一次修改）。

#git rm file

#git commit -m “remove file”

第二、误删了文件，想要恢复，因为版本库里还有，所以可以恢复过来

#git checkout -- file

 

10、添加远程库

要关联一个远程库，使用命令：

#git remote add origin git@server-name:path/repo-name.git；

关联后，使用命令#git push -u origin master第一次推送master分支的所有内容；

此后，每次本地提交后，只要有必要，就可以使用命令#git push origin master推送最新修改；

 

11、从远程库克隆

Ssh协议：#git clone git@github.com:path/repo-name.git

https协议：#git clone https://github.com/path/repo-name.git

 

12、 创建与合并分支

（1）查看分支：git branch

（2）创建分支：git branch name

（3）切换分支：git checkout name

（4）创建+切换分支：git checkout -b name

（5）合并某分支到当前分支：git merge name

（6）删除分支：git branch -d name

注：当Git无法自动合并分支时，就必须首先解决冲突。解决冲突后，再提交，合并完成。

（7）用git log --graph命令可以看到分支合并图。

 

13、分支管理策略

通常，合并分支时，如果可能，Git会用“Fast forward”模式，但这种模式下，删除分支后，会丢掉分支信息。

如果要强制禁用“Fast forward”模式，Git就会在merge时生成一个新的commit，这样，从分支历史上就可以看出分支信息。

#git merge --no-ff -m "merge with no-ff" name

因为本次合并要创建一个新的commit，所以加上-m参数，把commit描述写进去。

合并后，我们用git log看看分支历史：

#git log --graph --pretty=oneline --abbrev-commit

 

在实际开发中，我们应该按照几个基本原则进行分支管理：

首先，master分支应该是非常稳定的，也就是仅用来发布新版本，平时不能在上面干活；

那在哪干活呢？干活都在dev分支上，也就是说，dev分支是不稳定的，到某个时候，比如1.0版本发布时，再把dev分支合并到master上，在master分支发布1.0版本；

你和你的小伙伴们每个人都在dev分支上干活，每个人都有自己的分支，时不时地往dev分支上合并就可以了。

所以，团队合作的分支看起来就像这样：

14、BUG分支（保存工作现场）

修复bug时，我们会通过创建新的bug分支进行修复，然后合并，最后删除；

当手头工作没有完成时，先把工作现场git stash一下，然后去修复bug，修复后，再git stash pop，回到工作现场。

（1）保存当前工作现场，然后就可以创建bug分支：

#git stash

（2）修复完BUG后，切换为之前分支并合并，删除BUG分支然后回到工作分支，恢复工作现场：

#git stash list 查看储藏的工作现场

恢复工作现场有两个办法：

一是用git stash apply恢复，但是恢复后，stash内容并不删除，你需要用git stash drop来删除；

另一种方式是用git stash pop，恢复的同时把stash内容也删了：

你可以多次stash，恢复的时候，先用git stash list查看，然后恢复指定的stash，用命令：

$ git stash apply stash@{0}（git stash list 查看的结果）

 

15、创建一个新功能分支feature

开发一个新feature，最好新建一个分支；（创建分支-开发-提交-切回-合并-删除新分支）

如果要丢弃一个没有被合并过的分支，可以通过git branch -D name强行删除。

 

16、多人协作

（1）查看远程库信息：# git remote

（2）查看更详细的信息：#git remote –v

会显示了可以抓取和推送的origin的地址。如果没有推送权限，就看不到push的地址。

17、推送分支

推送分支，就是把该分支上的所有本地提交推送到远程库。推送时，要指定本地分支，这样，Git就会把该分支推送到远程库对应的远程分支上：

#git push origin branch-name

但是，并不是一定要把本地分支往远程推送，那么，哪些分支需要推送，哪些不需要呢？

（1）master分支是主分支，因此要时刻与远程同步；

（2）dev分支是开发分支，团队所有成员都需要在上面工作，所以也需要与远程同步；

（3）bug分支只用于在本地修复bug，就没必要推到远程了，除非老板要看看你每周到底修复了几个bug；

（4）feature分支是否推到远程，取决于你是否和你的小伙伴合作在上面开发。

总之，就是在Git中，分支完全可以在本地自己藏着玩，是否推送，视你的心情而定！

 

18、抓取分支

多人协作的工作模式通常是这样：

（1）首先，可以试图用git push origin branch-name推送自己的修改；

（2）如果推送失败，则因为远程分支比你的本地更新，需要先用git pull试图合并；

（3）如果合并有冲突，则解决冲突（手动修改），并在本地提交（git add/git commit）；

（4）没有冲突或者解决掉冲突后，再用git push origin branch-name推送就能成功！

（5）如果git pull提示“no tracking information”，则说明本地分支和远程分支的链接关系没有创建，用命令git branch --set-upstream branch-name origin/branch-name。

这就是多人协作的工作模式，一旦熟悉了，就非常简单。

在本地创建和远程分支对应的分支，使用git checkout -b branch-name origin/branch-name，本地和远程分支的名称最好一致；

 

19、创建标签

发布一个版本时，我们通常先在版本库中打一个标签，这样，就唯一确定了打标签时刻的版本。将来无论什么时候，取某个标签的版本，就是把那个打标签的时刻的历史版本取出来。所以，标签也是版本库的一个快照。

Git的标签虽然是版本库的快照，但其实它就是指向某个commit的指针（跟分支很像对不对？但是分支可以移动，标签不能移动），所以，创建和删除标签都是瞬间完成的。

（1）命令git tag tagname用于新建一个标签，默认为HEAD，

（2）也可以指定一个commit id；

#git branch 查看分支信息

#git tag tagname(v1.0) “commit id” 给指定分支创建标签

注意，标签不是按时间顺序列出，而是按字母排序的。可以用git show tagname查看标签信息：

（1） -a tagname -m "blablabla..."可以指定标签信息；

（2）-s tagname -m "blablabla..."可以用PGP签名标签；

（3） 命令git tag可以查看所有标签；

 

20、操作标签（删除、推送）

（1）命令git push origin tagname可以推送一个本地标签；

（2）命令git push origin --tags可以推送全部未推送过的本地标签；

（3）命令git tag -d tagname可以删除一个本地标签；

（4）命令git push origin :refs/tags/tagname可以删除一个远程标签。

 

21、忽略特殊文件

有些时候，你必须把某些文件放到Git工作目录中，但又不能提交它们。在Git工作区的根目录下创建一个特殊的.gitignore文件，然后把要忽略的文件名填进去，并将.gitignore文件提交到Git，Git就会自动忽略这些文件。

不需要从头写.gitignore文件，GitHub已经为我们准备了各种配置文件，只需要组合一下就可以使用了。所有配置文件可以直接在线浏览：https://github.com/github/gitignore

忽略文件的原则是：

忽略操作系统自动生成的文件，比如缩略图等；

忽略编译生成的中间文件、可执行文件等，也就是如果一个文件是通过另一个文件自动生成的，那自动生成的文件就没必要放进版本库，比如Java编译产生的.class文件；

忽略你自己的带有敏感信息的配置文件，比如存放口令的配置文件。

22、 配置别名

有没有经常敲错命令？比如git status？status这个单词真心不好记。

（1） 如果敲git st就表示git status那就简单多了，当然这种偷懒的办法我们是极力赞成的。

我们只需要敲一行命令，告诉Git，以后st就表示status：

$ git config --global alias.st status

（2）当然还有别的命令可以简写，很多人都用co表示checkout，ci表示commit，br表示branch：

$ git config --global alias.co checkout

$ git config --global alias.ci commit

$ git config --global alias.br branch

--global参数是全局参数，也就是这些命令在这台电脑的所有Git仓库下都有用。

（3） 在撤销修改一节中，我们知道，命令git reset HEAD file可以把暂存区的修改撤销掉（unstage），重新放回工作区。既然是一个unstage操作，就可以配置一个unstage别名：

$ git config --global alias.unstage 'reset HEAD'

当你敲入命令：

$ git unstage test.py

实际上Git执行的是：

$ git reset HEAD test.py

（4）配置一个git last，让其显示最后一次提交信息：

$ git config --global alias.last 'log -1'

这样，用git last就能显示最近一次的提交：

$ git last

commit adca45d317e6d8a4b23f9811c3d7b7f0f180bfe2

Merge: bd6ae48 291bea8

Author: Michael Liao <askxuefeng@gmail.com>

Date:   Thu Aug 22 22:49:22 2013 +0800

 

    merge & fix hello.py

（5）甚至还有人丧心病狂地把lg配置成了：

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"

来看看git lg的效果：

 

23、 配置文件

配置Git的时候，加上--global是针对当前用户起作用的，如果不加，那只针对当前的仓库起作用。

（1）配置文件放哪了？每个仓库的Git配置文件都放在.git/config文件中：

$ cat .git/config 

[core]

    repositoryformatversion = 0

    filemode = true

    bare = false

    logallrefupdates = true

    ignorecase = true

    precomposeunicode = true

[remote "origin"]

    url = git@github.com:michaelliao/learngit.git

    fetch = +refs/heads/*:refs/remotes/origin/*

[branch "master"]

    remote = origin

    merge = refs/heads/master

[alias]

    last = log -1

别名就在[alias]后面，要删除别名，直接把对应的行删掉即可。

（2）而当前用户的Git配置文件放在用户主目录下的一个隐藏文件.gitconfig中：

$ cat .gitconfig

[alias]

    co = checkout

    ci = commit

    br = branch

    st = status

[user]

    name = Your Name

    email = your@email.com

配置别名也可以直接修改这个文件，如果改错了，可以删掉文件重新通过命令配置。

参考资料：http://www.liaoxuefeng.com/wiki/0013739516305929606dd18361248578c67b8067c8c017b000

http://rogerdudler.github.io/git-guide/index.zh.html

http://www.open-open.com/lib/view/open1332904495999.html