Git教程总结，一些日常用到的基本方法-白红宇

Git教程总结，一些日常用到的基本方法

阅读量：6223 次

发布时间：2019-06-21

本文共 29078 字，大约阅读时间需要 96 分钟。

Git教程

前面已经介绍了Git的安装与用户的初始配置，接下来是Git的基本命令与代码上传。

【mkdir 文件夹名称】命令：在当前目录下创建一个指定名称的文件夹。

【cd 跳转的目录名称】命令：跳转到指定的目录下，可以使用相对路径和绝对路径。

【pwd】命令：显示当前目录。

由于使用Windows系统，为了避免遇到各种莫名其妙的问题，要确保目录名（包括父目录）不包含中文。

【git init】命令：在当前目录下创建一个版本库。

【ls –ah / ls -a】命令：显示当前目录下的所有目录和文件【包括以’.’开头的隐藏目录和隐藏文件】

【git status】命令：查看当前git仓库的状态。

【git add 文件名称(多个文件用空格隔开)】命令：往版本库的暂存区中添加纯文本文件。

【git add】命令允许多次添加，例如：

· | git add file1.txt

· | git add file2.txt file3.txt

· | git commit –m “commit 3 files to repository!”

· | 以上三条命令将file1，file2，file3提交到git仓库中。

【cat 当前目录下的某个文本文件】命令：显示指定文本文件的内容。

【git commit –m “注释信息”】命令：将暂存区中的文件提交到版本库中。

【git diff 文件名称】命令：通过git status命令发现未提交的已修改文件之后，可以利用git diff命令查看该文件的内容发生了什么改变。Git Bash会显示改变的内容与之前的内容。

【git log】命令：查看版本库中的详细提交日志【日志包括作者，提交日期，提交注释和commit id】。

【git log --pretty=oneline】命令：查看版本库中日志且一行输出一个版本信息【信息包括commit id和提交注释】。

【git reset --hard版本指定】命令：将已经提交的文件回溯到指定的版本，其中”版本指定”通过HEAD（当前的版本，与commit id版本号一定可以指定版本）来指定。HEAD^是上一个版本，HEAD^^是上上一个版本，如果是上100个版本则通过HEAD~100来完成。

【git reset --hard 版本号commit id】命令：通过指定确定的版本号来回溯到之前或者之后的版本。

【git reflog】命令：显示所有版本号日志，包括过去的版本和未来的版本。

【git reset HEAD 文件名称】命令：重写暂存区的目录树（包括文件），它将被master分支指向的目录树（包括文件）所替换，但是工作区不受影响。

git reset命令既可以回退版本，也可以把暂存区的修改回退到工作区。当我们用HEAD时，表示最新的版本。

【git checkout - 文件名称】命令：用当前暂存区的文件覆盖工作区的文件。

【git checkout .】命令：用当前暂存区的全部文件覆盖工作区的同名文件。通常命令后面加上一点而不是指定某一文件时，，命令表示对所有文件进行相同操作。

【rm 文件名称】命令：删除当前工作区的指定文件。

【git rm 文件名称】命令：删除当前暂存区中的指定文件并且删除工作区中的相同文件。

【git rm --cache 文件名称】命令：删除当前暂存区中的指定文件。

【cd ~/.ssh】命令：如果存在ssh目录/文件则跳转到该目录下，如果找不到该目录则显示不存在该目录文件。

【ssh-keygen –t ras –C “邮箱地址”】命令：生成SSH密钥对（公钥和密钥）。具体指令信息在Git Bash中会有提示。

【git remote –v】命令：罗列已经添加的远程库的名称和远程库的URL。

【git remote add 远程库名称远程库URL】命令：本地仓库添加远程仓库，一般远程仓库名称使用origin，远程库URL选择SSH类型。

【git pull 远程主机名称远程分支名称:本地分支名称】命令：本地仓库同步（拉取更合适）远程仓库的信息，将远程分支信息拉取到本地分支里。

【git push 远程主机名称本地分支名称:远程分支名称】命令：将本地仓库的指定分支推送到远程仓库的指定分支里。

【git pull/push 远程主机名称源分支名称:目的分支名称】git pull/push命令格式。

【注意：第一次本地仓库和远程仓库的通信必须先拉取远程仓库信息之后才可以推送本地仓库信息，这是为了避免远程仓库已有信息与本地仓库信息不对称的冲突】

【git clone SSH类型远程URL】命令：将远程仓库给克隆到本地仓库中。

【rm –rf 本地仓库的绝对地址】命令：删除指定路径的git仓库，这条命令执行之后可以删除该仓库所在的目录。

【git branch】命令：罗列当前的所有分支，并在当前分支前面追加*号以区别其他分支。

【git branch 分支名称】命令：创建一个新的分支。

【git checkout 分支名称】命令：切换到指定分支。

【git checkout –b 分支名称】命令：创建并切换到新分支。

【git merge 分支名称】命令：合并指定分支到当前分支。使用的是默认的快进式(fast forwarding)合并分支方式，它直接将当前分支的指针覆盖掉指定分支的指针，这时指定分支的指针就消失了。

【git branch –d 分支名称】命令：删除指定分支。

【vi 文件名称】命令：新建或者打开指定文件。

按一下Insert键进入编辑模式，编辑完毕之后可以保存并退出，此时光标移动到文末，按一下Esc键，然后切换到大写字母，连续输入ZZ两次就可以保存并退出；如果只想退出并且不保存当前的编辑，同样需要文末按下Esc键，然后输入“:”号。之后进入命令行模式，输入q!退出文本编辑。

【git log –graph –pretty=oneline –abbrev-commit】命令：图形方式显示git的分支开展情况。

【git merge --no-ff -m “注释” 分支名称】命令：使用no-ff(no fastforwarding)参数合并指定分支到当前分支。使用非快进式合并分支方式，它直接将当前分支的指针移动到指定分支处，此时指定分支和当前分支的指针都指向同一处。

【git stash】命令：将当前的工作区储存起来，储存的地方暂时就叫做储存域，储存的当前工作区称为储存区。

【git stash list】命令：查看当前储存域的所有储存工作区。

【git stash apply 储存区号stash@{XXX号}】命令：将指定储存区XXX给恢复到当前工作区，此时储存域中依然含有该条储存区信息。

【git stash drop 储存区号stash@{XXX号}】命令：将指定储存区XXX从储存域中删除。

【git stash pop储存区号stash@{XXX号}】命令；将指定储存区XXX从储存域中恢复到当前工作区并且将它从储存域中删除。

【git stash clear】命令：清空储存域。

【git branch –D 分支名称】命令；用于强行删除未合并到主分支的分支。

【git branch -a】命令：显示所有本地/远程分支以及当前本地/远程分支所指向的分支。

【git branch –r】命令：显示所有远程分支以及当前远程分支所指向的分支。

【git checkout –b 本地新建分支名称 origin/远程分支名称】命令：将指定远程分支创建到本地仓库指定分支（原本本地没有该指定分支）中。

【git branch –set-upstream 本地分支名称 origin/远程分支名称】命令：将本地分支与远程分支连接起来。

【git tag tag名称】命令：往当前分支的当前版本号commit id中添加标签tag。

【git tag tag名称版本号commit id】命令：往指定版本号commit id中添加标签tag。

【git tag】命令：显示所有标签信息。

【git tag –a 名称 –m “注释” commit id】命令：往指定版本号commit id中添加标签tag，并给tag添加注释。

【git show tag名称】命令：显示指定tag的详细内容。

【git tag –d tag名称】命令：删除本地的标签。

【git push origin :refs/tags/标签名称】命令：可以删除一个远程标签。

【git push origin tag名称】命令：推送一个本地标签。

【git push origin --tags】命令：推送全部未推送的本地标签。

【git log -1】命令：显示最近一次提交的内容。

【本地删除远程文件夹/文件】

【第零步：查看】【git rm –r –n –cached 文件夹名称/文件名称】命令：罗列指定远程文件夹的所有文件/文件，用来查看即将被删除的文件信息；

【第一步：删除】【git rm –r –cached 文件夹名称/文件名称】命令：删除指定远程文件夹的所有文件/文件；

【第二步：提交】【git commit –m “注释”】命令：提交删除到本地仓库；

【第三步：推送】【git push 远程主机名称本地分支名称:远程分支名称】命令：推送到远程主机。

【配置别名】

【git config --global alias.别名 “固定的命令片段”】命令：为指定的命令片段起别名。

例如：git config --global alias.ci ‘commit –m’将commit –m起别名为ci;

git config –global alias.br ‘branch’将branch起别名为br。

【别名的信息存储在.git/config配置文件的[alias]后面，如果想要取消该别名，只要直接将它从[alias]后面删除就可以了】

【附】通常开发新功能是通过新建一个feature分支来实现的，最后完成之后就将这个分支给合并到主分支并删除掉。

【专有名词：repository 版本库】

【专有名词：working directory工作区】

【专有名词：stage/index暂存区，目录中显示暂存区为index，Git Bash显示暂存区为stage】

▓▏创建版本库▕▓：

第一步：创建空目录

首先是找到一个合适的地方，创建一个空目录；

第二步：创建Git仓库

通过git init命令在这个目录创建Git可以管理的仓库【empty Git repository】；

此时当前目录下多了一个.git目录，该目录是Git用来跟踪管理版本库的，没事千万不要手动修改里面的文件，随便修改容易破坏Git仓库。

也不一定必须在空目录下创建Git仓库，选择一个已经有东西的目录也是可以的。不过，不建议你使用自己正在开发的项目来学习Git，否则造成的一切后果概不负责。

第三步：把文件添加到版本库

首先要明确的是，所有的版本控制系统，其实只能跟踪文本文件的改动，比如TXT文件，网页，所有的程序代码等等，Git也不例外。版本控制系统可以告诉你每次的改动，比如在第5行加了一个单词“Linux”，在第8行删了一个单词“Windows”。而图片、视频这些二进制文件，虽然也能由版本控制系统管理，但没法跟踪文件的变化，只能把二进制文件每次改动串起来，也就是只知道图片从100KB改成了120KB，但到底改了啥，版本控制系统不知道，也没法知道。

不幸的是，Microsoft的Word格式是二进制格式，因此，版本控制系统是没法跟踪Word文件的改动的，前面我们举的例子只是为了演示，如果要真正使用版本控制系统，就要以纯文本方式编写文件。

因为文本是有编码的，比如中文有常用的GBK编码，日文有Shift_JIS编码，如果没有历史遗留问题，强烈建议使用标准的UTF-8编码，所有语言使用同一种编码，既没有冲突，又被所有平台所支持。

▓▏往版本库中添加文件▕▓：

第一步：新建文本文件

在工作区（或者它的子目录）下建立纯文本文件”readme.txt”，

第二步：将readme.txt添加到git中

查看当前的git状态，提示untracked files有readme.txt文件，这时就可以将该文件添加到index暂存区中了，直接使用git add “纯文本文件名称”命令可以完成该操作；查看git状态，提示有待提交文件在暂存区中，通过使用git commit –m “注释”命令将暂存区中的所有文件提交到git上面，最后是查看git状态，提示该分支没有文件待提交且工作区为空。

▓▏版本更替▕▓：

第一步：修改readme.txt文件

第二步：提交修改过后的readme.txt到git仓库中

先用git status查看git仓库状态，然后利用git diff查看与之前版本的差异，明确差异之后确定是否将该文件提交到git仓库中。明确要提交之后先将文件提交到index暂存区中，再次查看git仓库状态并提交暂存区的文件到git仓库中，最后再查看一次git仓库状态。

▓▏追溯版本▕▓：

第一步：再次修改文件并提交到git版本库中

然后通过git add命令和git commit命令将修改过的readme.txt文件提交到git版本库中。我们不断地修改文件并提交到版本库中，Git会不断地保存commit（可以看做是一个快照），一旦把文件误删了或者改乱了，我们可以从最近的一个commit中恢复文件并继续工作。

第二步：将readme.txt回溯到第二版本

首先利用git log命令或者 git log --pretty=oneline命令得到各版本的具体信息，其中会有一串长长的字符串是16进制的commit id，它是每个版本的版本号。【也可以通过Git GUI来查看版本历史】

然后通过git reset --hard命令来回溯，其中--hard参数如果是HEAD类型则只能回溯到之前的版本，而如果是指定版本号commit id的话那就可以回溯到某个未来的版本。版本号不用写全，前几位就可以了，Git会自动去匹配。

commit id可以通过git reflog命令来获取，然后再通过git reset --hard commit id就可以回溯到未来的版本了。

▓▏工作区和暂存区▕▓：

工作区（Working Directory）指在电脑里可以看到的目录，比如learngit文件夹就是一个工作区；

版本库（Repository）指位于工作区中的一个隐藏目录.git，它不属于工作区，而是Git的版本库。

暂存区（index）指位于版本库中的index文件，其次，新建一个版本库Git会为我们自动创建第一个分支master和指向master的一个指针HEAD。

我们把文件往Git版本库里添加的时候，是分两步执行的：

第一步：用git add把文件添加进去，实际上就是把文件修改添加到暂存区；

第二步：用git commit提交更改，实际上就是把暂存区的所有内容提交到当前分支。

因为我们创建Git版本库时，Git自动为我们创建了唯一一个master分支，所以，现在，git commit就是往master分支上提交更改。

你可以简单理解为，需要提交的文件修改通通放到暂存区，然后，一次性提交暂存区的所有修改。

现在，我们再练习一遍，先对readme.txt做个修改，比如加上一行内容；然后，在工作区新增一个LICENSE文本文件（内容随便写）。

先用git status查看一下状态：

Git非常清楚地告诉我们，readme.txt被修改了，而LICENSE还从来没有被添加过，所以它的状态是Untracked。

现在，使用两次命令git add，把readme.txt和LICENSE都添加后，用git status再查看一下。现在，暂存区的状态就变成这样了：

所以，git add命令实际上就是把要提交的所有修改放到暂存区（Stage），然后，执行git commit就可以一次性把暂存区的所有修改提交到分支。

一旦提交后，如果你又没有对工作区做任何修改，那么工作区就是“干净”的：

暂存区是Git非常重要的概念，弄明白了暂存区，就弄明白了Git的很多操作到底干了什么。

▓▏管理修改▕▓：

Git跟踪并管理的是修改，而非文件，所以Git比其他版本控制系统设计得优秀。

什么是修改？比如新增了一行，这就是一个修改，删除了一行，也是一个修改，更改了某些字符，也是一个修改，删了一些又加了一些，也是一个修改，甚至创建一个新文件，也算一个修改。

为什么说Git管理的是修改，而不是文件呢？

实验测试：

第一步：对readme.txt做一个修改，比如加一行内容，然后用git add readme.txt将readme.txt添加到暂存区中，之后再修改readme.txt并直接提交暂存区文件到git仓库中。

第二步：提交之后查看git仓库状态，发现第二次修改没有提交。这是因为：

第一次修改 -> git add -> 第二次修改 -> git commit

我们前面讲了，Git管理的是修改，当你用git add命令后，在工作区的第一次修改被放入暂存区，准备提交，但是，在工作区的第二次修改并没有放入暂存区，所以，git commit只负责把暂存区的修改提交了，也就是第一次的修改被提交了，第二次的修改不会被提交。

提交后，用git diff HEAD -- readme.txt或者git diff reademe.txt命令可以查看工作区和版本库里面最新版本的区别。

那怎么提交第二次修改呢？可以继续git add再git commit；也可以别着急提交第一次修改，先git add第二次修改，再git commit，就相当于把两次修改合并后一块提交了：

第一次修改 -> git add -> 第二次修改 -> git add -> git commit

Git是如何跟踪修改的，每次修改，如果不add到暂存区，那就不会加入到commit中。

▓▏撤销修改▕▓：

当发现准备提交（已经添加到暂存区）的文本文件有错误时，我们可以删掉最后一行，手动把文件恢复到上一个版本的状态。

①设当前readme.txt文件已经修改，但是还没有添加到暂存区中，那么我们可以直接通过Ctrl + Z来撤销文件的修改而不用恢复到上一个版本状态。或者直接在Git Bash中使用git checkout – “文件名称”来撤销修改。

②假设当前readme.txt文件已经修改并添加到暂存区中了，那么我们如何撤回暂存区中的文件呢？

③假设当前readme.txt文件已经修改并添加到暂存区中了，那么我们如何撤回暂存区中的文件呢？

如果这时还没有把自己的本地版本库推送到远程，那就可以使用版本回溯功能了，通过git reset –hard HEAD^回溯到前一个版本或者使用git reset –hard HEAD~XX回溯到前XX个版本。

如果已经把本地版本库推送到远程的话，那就无法彻底撤销修改了。

▓▏删除文件▕▓：

在Git中，删除也是一个修改操作，我们实战一下，先添加一个新文件test.txt到Git并且提交.

一般情况下，你通常直接在文件管理器中把没用的文件删了，或者用rm命令删了。这个时候，Git知道你删除了文件，因此，工作区和版本库就不一致了，git status命令会立刻告诉你哪些文件被删除了。

现在你有两个选择，一是确实要从版本库中删除该文件，那就用命令git rm删掉，并且git commit。现在，文件就从版本库中被删除了。

另一种情况是删错了，因为版本库里还有呢，所以可以很轻松地把误删的文件恢复到最新版本：git checkout其实是用版本库里的版本替换工作区的版本，无论工作区是修改还是删除，都可以“一键还原”。

命令git rm用于删除一个文件。如果一个文件已经被提交到版本库，那么你永远不用担心误删，但是要小心，你只能恢复文件到最新版本，你会丢失最近一次提交后你修改的内容。

▓▏远程仓库▕▓：

我们把远程仓库托管到Git@OSC中。创建远程仓库需要以下步骤：

第一步：Git@OSC上创建新项目；第二步：生成密钥对；第三步：Git@OSC上添加公钥。

具体过程参见”远程仓库的建立.docx”文档。超链接：远程仓库的建立.docx

▓▏同步远程库▕▓：

第一步：在Git@OSC上建立一个远程仓库；

第二步：本地仓库添加远程库；

第三步：将远程仓库与本地仓库连接起来；

第四步：进行仓库的版本推送和版本拉取。超链接：远程仓库的推送和拉取.docx

▓▏克隆远程仓库▕▓：

第一步：在Git@OSC上建立一个远程仓库；

第二步：通过git clone SSH类型远程库URL命令将远程仓库克隆到本地仓库中，注意克隆下来会生成一个目录文件夹和git仓库，所以一般都是项目名称与整个项目切合，然！@#后克隆时指定项目的父路径，然后克隆命令会自动生成项目文件夹和本地仓库。

▓▏分支管理▕▓：

分支就是科幻电影里面的平行宇宙，当你正在电脑前努力学习Git的时候，另一个你正在另一个平行宇宙里努力学习SVN。

如果两个平行宇宙互不干扰，那对现在的你也没啥影响。不过，在某个时间点，两个平行宇宙合并了，结果，你既学会了Git又学会了SVN！

分支在实际中有什么用呢？假设你准备开发一个新功能，但是需要两周才能完成，第一周你写了50%的代码，如果立刻提交，由于代码还没写完，不完整的代码库会导致别人不能干活了。如果等代码全部写完再一次提交，又存在丢失每天进度的巨大风险。

现在有了分支，就不用怕了。你创建了一个属于你自己的分支，别人看不到，还继续在原来的分支上正常工作，而你在自己的分支上干活，想提交就提交，直到开发完毕后，再一次性合并到原来的分支上，这样，既安全，又不影响别人工作。

其他版本控制系统如SVN等都有分支管理，但是用过之后你会发现，这些版本控制系统创建和切换分支比蜗牛还慢，简直让人无法忍受，结果分支功能成了摆设，大家都不去用。

但Git的分支是与众不同的，无论创建、切换和删除分支，Git在1秒钟之内就能完成！无论你的版本库是1个文件还是1万个文件。

▓▏创建和合并分支▕▓：

在里，你已经知道，每次提交，Git都把它们串成一条时间线，这条时间线就是一个分支。截止到目前，只有一条时间线，在Git里，这个分支叫主分支，即master分支。HEAD严格来说不是指向提交，而是指向master，master才是指向提交的，所以，HEAD指向的就是当前分支。

一开始的时候，master分支是一条线，Git用master指向最新的提交，再用HEAD指向master，就能确定当前分支，以及当前分支的提交点：

每次提交，master分支都会向前移动一步，这样，随着你不断提交，master分支的线也越来越长：

当我们创建新的分支，例如dev时，Git新建了一个指针叫dev，指向master相同的提交，再把HEAD指向dev，就表示当前分支在dev上：

你看，Git创建一个分支很快，因为除了增加一个dev指针，改改HEAD的指向，工作区的文件都没有任何变化！

不过，从现在开始，对工作区的修改和提交就是针对dev分支了，比如新提交一次后，dev指针往前移动一步，而master指针不变：

假如我们在dev上的工作完成了，就可以把dev合并到master上。Git怎么合并呢？最简单的方法，就是直接把master指向dev的当前提交，就完成了合并：

所以Git合并分支也很快！就改改指针，工作区内容也不变！

合并完分支后，甚至可以删除dev分支。删除dev分支就是把dev指针给删掉，删掉后，我们就剩下了一条master分支：

真是太神奇了，你看得出来有些提交是通过分支完成的吗？

下面开始实战。

首先，我们创建dev分支，然后切换到dev分支：

$ git checkout -b dev

Switched to a new branch 'dev'

git checkout命令加上-b参数表示创建并切换，相当于以下两条命令：

$ git branch dev

$ git checkout dev

Switched to branch 'dev'

然后，用git branch命令查看当前分支：

$ git branch

* dev

master

git branch命令会列出所有分支，当前分支前面会标一个*号。

然后，我们就可以在dev分支上正常提交，比如对readme.txt做个修改，加上一行：

Creating a new branch is quick.

然后提交：

$ git add readme.txt

$ git commit -m "branch test"

[dev fec145a] branch test

1 file changed, 1 insertion(+)

现在，dev分支的工作完成，我们就可以切换回master分支：

$ git checkout master

Switched to branch 'master'

切换回master分支后，再查看一个readme.txt文件，刚才添加的内容不见了！因为那个提交是在dev分支上，而master分支此刻的提交点并没有变：

现在，我们把dev分支的工作成果合并到master分支上：

$ git merge dev

Updating d17efd8..fec145a

Fast-forward

readme.txt | 1 +

1 file changed, 1 insertion(+)

git merge命令用于合并指定分支到当前分支。合并后，再查看readme.txt的内容，就可以看到，和dev分支的最新提交是完全一样的。

注意到上面的Fast-forward信息，Git告诉我们，这次合并是“快进模式”，也就是直接把master指向dev的当前提交，所以合并速度非常快。

当然，也不是每次合并都能Fast-forward，我们后面会将其他方式的合并。

合并完成后，就可以放心地删除dev分支了：

$ git branch -d dev

Deleted branch dev (was fec145a).

删除后，查看branch，就只剩下master分支了：

$ git branch

* master

因为创建、合并和删除分支非常快，所以Git鼓励你使用分支完成某个任务，合并后再删掉分支，这和直接在master分支上工作效果是一样的，但过程更安全。

Git鼓励大量使用分支。

▓▏合并分支的冲突处理▕▓：

人生不如意之事十之八九，合并分支往往也不是一帆风顺的。

准备新的feature1分支，继续我们的新分支开发：

$ git checkout -b feature1

Switched to a new branch 'feature1'

修改readme.txt最后一行，改为：

Creating a new branch is quick AND simple.

在feature1分支上提交：

$ git add readme.txt

$ git commit -m "AND simple"

[feature1 75a857c] AND simple

1 file changed, 1 insertion(+), 1 deletion(-)

切换到master分支：

$ git checkout master

Switched to branch 'master'

Your branch is ahead of 'origin/master' by 1 commit.

Git还会自动提示我们当前master分支比远程的master分支要超前1个提交。

在master分支上把readme.txt文件的最后一行改为：

Creating a new branch is quick & simple.

提交：

$ git add readme.txt

$ git commit -m "& simple"

[master 400b400] & simple

1 file changed, 1 insertion(+), 1 deletion(-)

现在，master分支和feature1分支各自都分别有新的提交，变成了这样：

这种情况下，Git无法执行“快速合并”，只能试图把各自的修改合并起来，但这种合并就可能会有冲突，我们试试看：

$ git merge feature1

Auto-merging readme.txt

CONFLICT (content): Merge conflict in readme.txt

Automatic merge failed; fix conflicts and then commit the result.

果然冲突了！Git告诉我们，readme.txt文件存在冲突，必须手动解决冲突后再提交。git status也可以告诉我们冲突的文件：

$ git status

# On branch master

# Your branch is ahead of 'origin/master' by 2 commits.

# Unmerged paths:

# (use "git add/rm <file>..." as appropriate to mark resolution)

# both modified: readme.txt

no changes added to commit (use "git add" and/or "git commit -a")

我们可以直接编辑readme.txt的内容：

Git is a distributed version control system.

Git is free software distributed under the GPL.

Git has a mutable index called stage.

Git tracks changes of files.

<<<<<<< HEAD

Creating a new branch is quick & simple.

=======

Creating a new branch is quick AND simple.

>>>>>>> feature1

Git用<<<<<<<，=======，>>>>>>>标记出不同分支的内容，我们修改如下后保存：

Creating a new branch is quick and simple.

再提交：

$ git add readme.txt

$ git commit -m "conflict fixed"

[master 59bc1cb] conflict fixed

现在，master分支和feature1分支变成了下图所示：

用带参数的git log也可以看到分支的合并情况：

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

* 59bc1cb conflict fixed

| * 75a857c AND simple

* | 400b400 & simple

* fec145a branch test

...

最后，删除feature1分支：

$ git branch -d feature1

Deleted branch feature1 (was 75a857c).

工作完成。

小结

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

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

▓▏分支管理策略▕▓：

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

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

下面我们实战一下--no-ff方式的git merge：

首先，仍然创建并切换dev分支：

$ git checkout -b dev

Switched to a new branch 'dev'

修改readme.txt文件，并提交一个新的commit：

$ git add readme.txt

$ git commit -m "add merge"

[dev 6224937] add merge

1 file changed, 1 insertion(+)

现在，我们切换回master：

$ git checkout master

Switched to branch 'master'

准备合并dev分支，请注意--no-ff参数，表示禁用Fast forward：

$ git merge --no-ff -m "merge with no-ff" dev

Merge made by the 'recursive' strategy.

readme.txt | 1 +

1 file changed, 1 insertion(+)

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

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

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

* 7825a50 merge with no-ff

| * 6224937 add merge

* 59bc1cb conflict fixed

...

可以看到，不使用Fast forward模式，merge后就像这样：

分支策略

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

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

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

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

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

小结

Git分支十分强大，在团队开发中应该充分应用。

合并分支时，加上--no-ff参数就可以用普通模式合并，合并后的历史有分支，能看出来曾经做过合并，而fast forward合并就看不出来曾经做过合并。

▓▏fixbug分支▕▓：

软件开发中，bug就像家常便饭一样。有了bug就需要修复，在Git中，由于分支是如此的强大，所以，每个bug都可以通过一个新的临时分支来修复，修复后，合并分支，然后将临时分支删除。

当你接到一个修复一个代号101的bug的任务时，很自然地，你想创建一个分支issue-101来修复它，但是，等等，当前正在dev上进行的工作还没有提交：

$ git status

# On branch dev

# Changes to be committed:

# (use "git reset HEAD <file>..." to unstage)

# new file: hello.py

# Changes not staged for commit:

# (use "git add <file>..." to update what will be committed)

# (use "git checkout -- <file>..." to discard changes in working directory)

# modified: readme.txt

并不是你不想提交，而是工作只进行到一半，还没法提交，预计完成还需1天时间。但是，必须在两个小时内修复该bug，怎么办？

幸好，Git还提供了一个stash功能，可以把当前工作现场“储藏”起来，等以后恢复现场后继续工作：

$ git stash

Saved working directory and index state WIP on dev: 6224937 add merge

HEAD is now at 6224937 add merge

现在，用git status查看工作区，就是干净的（除非有没有被Git管理的文件），因此可以放心地创建分支来修复bug。

首先确定要在哪个分支上修复bug，假定需要在master分支上修复，就从master创建临时分支：

$ git checkout master

Switched to branch 'master'

Your branch is ahead of 'origin/master' by 6 commits.

$ git checkout -b issue-101

Switched to a new branch 'issue-101'

现在修复bug，需要把“Git is free software ...”改为“Git is a free software ...”，然后提交：

$ git add readme.txt

$ git commit -m "fix bug 101"

[issue-101 cc17032] fix bug 101

1 file changed, 1 insertion(+), 1 deletion(-)

修复完成后，切换到master分支，并完成合并，最后删除issue-101分支：

$ git checkout master

Switched to branch 'master'

Your branch is ahead of 'origin/master' by 2 commits.

$ git merge --no-ff -m "merged bug fix 101" issue-101

Merge made by the 'recursive' strategy.

readme.txt | 2 +-

1 file changed, 1 insertion(+), 1 deletion(-)

$ git branch -d issue-101

Deleted branch issue-101 (was cc17032).

太棒了，原计划两个小时的bug修复只花了5分钟！现在，是时候接着回到dev分支干活了！

$ git checkout dev

Switched to branch 'dev'

$ git status

# On branch dev

nothing to commit (working directory clean)

工作区是干净的，刚才的工作现场存到哪去了？用git stash list命令看看：

$ git stash list

stash@{0}: WIP on dev: 6224937 add merge

工作现场还在，Git把stash内容存在某个地方了，但是需要恢复一下，有两个办法：

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

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

$ git stash pop

# On branch dev

# Changes to be committed:

# (use "git reset HEAD <file>..." to unstage)

# new file: hello.py

# Changes not staged for commit:

# (use "git add <file>..." to update what will be committed)

# (use "git checkout -- <file>..." to discard changes in working directory)

# modified: readme.txt

Dropped refs/stash@{0} (f624f8e5f082f2df2bed8a4e09c12fd2943bdd40)

再用git stash list查看，就看不到任何stash内容了：

$ git stash list

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

$ git stash apply stash@{0}

小结

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

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

▓▏Feature功能分支▕▓：

软件开发中，总有无穷无尽的新的功能要不断添加进来。

添加一个新功能时，你肯定不希望因为一些实验性质的代码，把主分支搞乱了，所以，每添加一个新功能，最好新建一个feature分支，在上面开发，完成后，合并，最后，删除该feature分支。

现在，你终于接到了一个新任务：开发代号为Vulcan的新功能，该功能计划用于下一代星际飞船。

于是准备开发：

$ git checkout -b feature-vulcan

Switched to a new branch 'feature-vulcan'

5分钟后，开发完毕：

$ git add vulcan.py

$ git status

# On branch feature-vulcan

# Changes to be committed:

# (use "git reset HEAD <file>..." to unstage)

# new file: vulcan.py

$ git commit -m "add feature vulcan"

[feature-vulcan 756d4af] add feature vulcan

1 file changed, 2 insertions(+)

create mode 100644 vulcan.py

切回dev，准备合并：

$ git checkout dev

一切顺利的话，feature分支和bug分支是类似的，合并，然后删除。

但是，

就在此时，接到上级命令，因经费不足，新功能必须取消！

虽然白干了，但是这个分支还是必须就地销毁：

$ git branch -d feature-vulcan

error: The branch 'feature-vulcan' is not fully merged.

If you are sure you want to delete it, run 'git branch -D feature-vulcan'.

销毁失败。Git友情提醒，feature-vulcan分支还没有被合并，如果删除，将丢失掉修改，如果要强行删除，需要使用命令git branch -D feature-vulcan。

现在我们强行删除：

$ git branch -D feature-vulcan

Deleted branch feature-vulcan (was 756d4af).

终于删除成功！

小结

开发一个新feature，最好新建一个分支；

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

▓▏多人协作▕▓：

当你从远程仓库克隆时，实际上Git自动把本地的master分支和远程的master分支对应起来了，并且，远程仓库的默认名称是origin。

要查看远程库的信息，用git remote：

$ git remote

origin

或者，用git remote -v显示更详细的信息：

$ git remote -v

origin git@github.com:michaelliao/learngit.git (fetch)

origin git@github.com:michaelliao/learngit.git (push)

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

推送分支

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

$ git push origin master

如果要推送其他分支，比如dev，就改成：

$ git push origin dev

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

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

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

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

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

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

抓取分支

多人协作时，大家都会往master和dev分支上推送各自的修改。

现在，模拟一个你的小伙伴，可以在另一台电脑（注意要把SSH Key添加到GitHub）或者同一台电脑的另一个目录下克隆：

$ git clone git@github.com:michaelliao/learngit.git

Cloning into 'learngit'...

remote: Counting objects: 46, done.

remote: Compressing objects: 100% (26/26), done.

remote: Total 46 (delta 16), reused 45 (delta 15)

Receiving objects: 100% (46/46), 15.69 KiB | 6 KiB/s, done.

Resolving deltas: 100% (16/16), done.

当你的小伙伴从远程库clone时，默认情况下，你的小伙伴只能看到本地的master分支。不信可以用git branch命令看看：

$ git branch

* master

现在，你的小伙伴要在dev分支上开发，就必须创建远程origin的dev分支到本地，于是他用这个命令创建本地dev分支：

$ git checkout -b dev origin/dev

现在，他就可以在dev上继续修改，然后，时不时地把dev分支push到远程：

$ git commit -m "add /usr/bin/env"

[dev 291bea8] add /usr/bin/env

1 file changed, 1 insertion(+)

$ git push origin dev

Counting objects: 5, done.

Delta compression using up to 4 threads.

Compressing objects: 100% (2/2), done.

Writing objects: 100% (3/3), 349 bytes, done.

Total 3 (delta 0), reused 0 (delta 0)

To git@github.com:michaelliao/learngit.git

fc38031..291bea8 dev -> dev

你的小伙伴已经向origin/dev分支推送了他的提交，而碰巧你也对同样的文件作了修改，并试图推送：

$ git add hello.py

$ git commit -m "add coding: utf-8"

[dev bd6ae48] add coding: utf-8

1 file changed, 1 insertion(+)

$ git push origin dev

To git@github.com:michaelliao/learngit.git

! [rejected] dev -> dev (non-fast-forward)

error: failed to push some refs to 'git@github.com:michaelliao/learngit.git'

hint: Updates were rejected because the tip of your current branch is behind

hint: its remote counterpart. Merge the remote changes (e.g. 'git pull')

hint: before pushing again.

hint: See the 'Note about fast-forwards' in 'git push --help' for details.

推送失败，因为你的小伙伴的最新提交和你试图推送的提交有冲突，解决办法也很简单，Git已经提示我们，先用git pull把最新的提交从origin/dev抓下来，然后，在本地合并，解决冲突，再推送：

$ git pull

remote: Counting objects: 5, done.

remote: Compressing objects: 100% (2/2), done.

remote: Total 3 (delta 0), reused 3 (delta 0)

Unpacking objects: 100% (3/3), done.

From github.com:michaelliao/learngit

fc38031..291bea8 dev -> origin/dev

There is no tracking information for the current branch.

Please specify which branch you want to merge with.

See git-pull(1) for details

git pull <remote> <branch>

If you wish to set tracking information for this branch you can do so with:

git branch --set-upstream dev origin/<branch>

git pull也失败了，原因是没有指定本地dev分支与远程origin/dev分支的链接，根据提示，设置dev和origin/dev的链接：

$ git branch --set-upstream dev origin/dev

Branch dev set up to track remote branch dev from origin.

再pull：

$ git pull

Auto-merging hello.py

CONFLICT (content): Merge conflict in hello.py

Automatic merge failed; fix conflicts and then commit the result.

这回git pull成功，但是合并有冲突，需要手动解决，解决的方法和分支管理中的完全一样。解决后，提交，再push：

$ git commit -m "merge & fix hello.py"

[dev adca45d] merge & fix hello.py

$ git push origin dev

Counting objects: 10, done.

Delta compression using up to 4 threads.

Compressing objects: 100% (5/5), done.

Writing objects: 100% (6/6), 747 bytes, done.

Total 6 (delta 0), reused 0 (delta 0)

To git@github.com:michaelliao/learngit.git

291bea8..adca45d dev -> dev

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

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

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

如果合并有冲突，则解决冲突，并在本地提交；

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

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

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

小结

查看远程库信息，使用git remote -v；

本地新建的分支如果不推送到远程，对其他人就是不可见的；

从本地推送分支，使用git push origin branch-name，如果推送失败，先用git pull抓取远程的新提交；

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

建立本地分支和远程分支的关联，使用git branch --set-upstream branch-name origin/branch-name；

从远程抓取分支，使用git pull，如果有冲突，要先处理冲突。

▓▏标签管理▕▓：

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

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

▓▏创建标签▕▓：

在Git中打标签非常简单，首先，切换到需要打标签的分支上：

$ git branch

* dev

master

$ git checkout master

Switched to branch 'master'

然后，敲命令git tag <name>就可以打一个新标签：

$ git tag v1.0

可以用命令git tag查看所有标签：

$ git tag

v1.0

默认标签是打在最新提交的commit上的。有时候，如果忘了打标签，比如，现在已经是周五了，但应该在周一打的标签没有打，怎么办？

方法是找到历史提交的commit id，然后打上就可以了：

$ git log --pretty=oneline --abbrev-commit

6a5819e merged bug fix 101

cc17032 fix bug 101

7825a50 merge with no-ff

6224937 add merge

59bc1cb conflict fixed

400b400 & simple

75a857c AND simple

fec145a branch test

d17efd8 remove test.txt

...

比方说要对add merge这次提交打标签，它对应的commit id是6224937，敲入命令：

$ git tag v0.9 6224937

再用命令git tag查看标签：

$ git tag

v0.9

v1.0

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

$ git show v0.9

commit 622493706ab447b6bb37e4e2a2f276a20fed2ab4

Author: Michael Liao <askxuefeng@gmail.com>

Date: Thu Aug 22 11:22:08 2013 +0800

add merge

...

可以看到，v0.9确实打在add merge这次提交上。

还可以创建带有说明的标签，用-a指定标签名，-m指定说明文字：

$ git tag -a v0.1 -m "version 0.1 released" 3628164

用命令git show <tagname>可以看到说明文字：

$ git show v0.1

tag v0.1

Tagger: Michael Liao <askxuefeng@gmail.com>

Date: Mon Aug 26 07:28:11 2013 +0800

version 0.1 released

commit 3628164fb26d48395383f8f31179f24e0882e1e0

Author: Michael Liao <askxuefeng@gmail.com>

Date: Tue Aug 20 15:11:49 2013 +0800

append GPL

还可以通过-s用私钥签名一个标签：

$ git tag -s v0.2 -m "signed version 0.2 released" fec145a

签名采用PGP签名，因此，必须首先安装gpg（GnuPG），如果没有找到gpg，或者没有gpg密钥对，就会报错：

gpg: signing failed: secret key not available

error: gpg failed to sign the data

error: unable to sign the tag

如果报错，请参考GnuPG帮助文档配置Key。

用命令git show <tagname>可以看到PGP签名信息：

$ git show v0.2

tag v0.2

Tagger: Michael Liao <askxuefeng@gmail.com>

Date: Mon Aug 26 07:28:33 2013 +0800

signed version 0.2 released

-----BEGIN PGP SIGNATURE-----

Version: GnuPG v1.4.12 (Darwin)

iQEcBAABAgAGBQJSGpMhAAoJEPUxHyDAhBpT4QQIAKeHfR3bo...

-----END PGP SIGNATURE-----

commit fec145accd63cdc9ed95a2f557ea0658a2a6537f

Author: Michael Liao <askxuefeng@gmail.com>

Date: Thu Aug 22 10:37:30 2013 +0800

branch test

用PGP签名的标签是不可伪造的，因为可以验证PGP签名。验证签名的方法比较复杂，这里就不介绍了。

小结

命令git tag <name>用于新建一个标签，默认为HEAD，也可以指定一个commit id；

git tag -a <tagname> -m "blablabla..."可以指定标签信息；

git tag -s <tagname> -m "blablabla..."可以用PGP签名标签；

命令git tag可以查看所有标签。

▓▏操作标签▕▓：

如果标签打错了，也可以删除：

$ git tag -d v0.1

Deleted tag 'v0.1' (was e078af9)

因为创建的标签都只存储在本地，不会自动推送到远程。所以，打错的标签可以在本地安全删除。

如果要推送某个标签到远程，使用命令git push origin <tagname>：

$ git push origin v1.0

Total 0 (delta 0), reused 0 (delta 0)

To git@github.com:michaelliao/learngit.git

* [new tag] v1.0 -> v1.0

或者，一次性推送全部尚未推送到远程的本地标签：

$ git push origin --tags

Counting objects: 1, done.

Writing objects: 100% (1/1), 554 bytes, done.

Total 1 (delta 0), reused 0 (delta 0)

To git@github.com:michaelliao/learngit.git

* [new tag] v0.2 -> v0.2

* [new tag] v0.9 -> v0.9

如果标签已经推送到远程，要删除远程标签就麻烦一点，先从本地删除：

$ git tag -d v0.9

Deleted tag 'v0.9' (was 6224937)

然后，从远程删除。删除命令也是push，但是格式如下：

$ git push origin :refs/tags/v0.9

To git@github.com:michaelliao/learngit.git

- [deleted] v0.9

要看看是否真的从远程库删除了标签，可以登陆GitHub查看。

小结

命令git push origin <tagname>可以推送一个本地标签；

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

命令git tag -d <tagname>可以删除一个本地标签；

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

▓▏忽略特殊文件▕▓：

有些时候，你必须把某些文件放到Git工作目录中，但又不能提交它们，比如保存了数据库密码的配置文件啦，等等，每次git status都会显示Untracked files ...，有强迫症的童鞋心里肯定不爽。

好在Git考虑到了大家的感受，这个问题解决起来也很简单，在Git工作区的根目录下创建一个特殊的.gitignore文件，然后把要忽略的文件名填进去，Git就会自动忽略这些文件。

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

忽略文件的原则是：

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

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

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

举个例子：

假设你在Windows下进行Python开发，Windows会自动在有图片的目录下生成隐藏的缩略图文件，如果有自定义目录，目录下就会有Desktop.ini文件，因此你需要忽略Windows自动生成的垃圾文件：

# Windows:

Thumbs.db

ehthumbs.db

Desktop.ini

然后，继续忽略Python编译产生的.pyc、.pyo、dist等文件或目录：

# Python:

*.py[cod]

*.so

*.egg

*.egg-info

dist

build

加上你自己定义的文件，最终得到一个完整的.gitignore文件，内容如下：

# Windows:

Thumbs.db

ehthumbs.db

Desktop.ini

# Python:

*.py[cod]

*.so

*.egg

*.egg-info

dist

build

# My configurations:

db.ini

deploy_key_rsa

最后一步就是把.gitignore也提交到Git，就完成了！当然检验.gitignore的标准是git status命令是不是说working directory clean。

使用Windows的童鞋注意了，如果你在资源管理器里新建一个.gitignore文件，它会非常弱智地提示你必须输入文件名，但是在文本编辑器里“保存”或者“另存为”就可以把文件保存为.gitignore了。

小结

忽略某些文件时，需要编写.gitignore；

.gitignore文件本身要放到版本库里，并且可以对.gitignore做版本管理！

▓▏配置别名▕▓：

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

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

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

$ git config --global alias.st status

好了，现在敲git st看看效果。

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

$ git config --global alias.co checkout

$ git config --global alias.ci commit

$ git config --global alias.br branch

以后提交就可以简写成：

$ git ci -m "bala bala bala..."

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

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

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

当你敲入命令：

$ git unstage test.py

实际上Git执行的是：

$ git reset HEAD test.py

配置一个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

甚至还有人丧心病狂地把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的效果：

为什么不早点告诉我？别激动，咱不是为了多记几个英文单词嘛！

配置文件

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

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

$ cat .git/config

[core]

repositoryformatversion = 0

filemode = true

bare = false

logallrefupdates = true

ignorecase = true