diff --git a/Git图解.md b/Git图解.md new file mode 100644 index 0000000..2efe78e --- /dev/null +++ b/Git图解.md @@ -0,0 +1,113 @@ +Git图解 +======== + +> BY 童仲毅(geeeeeeeeek@github) +> +> 这是一篇在[原文](http://marklodato.github.io/visual-git-guide/index-zh-cn.html)基础上演绎的文章。原作者[Mark Lodato](lodatom@gmail.com)，译者[wych](ellrywych@gmail.com)。原文采用[创用CC 姓名标示-非商业性-相同方式分享3.0 美国授权条款](https://creativecommons.org/licenses/by-nc-sa/3.0/us/)授权。 + +此页图解git中的最常用命令。如果你稍微理解git的工作原理，这篇文章能够让你理解的更透彻。 + + +基本用法 +--------- +![enter image description here](http://marklodato.github.io/visual-git-guide/basic-usage.svg) +上面的四条命令在工作目录、stage缓存(也叫做索引)和commit历史之间复制文件。 + + * `git add files` 把工作目录中的文件加入stage缓存 + * `git commit` 把stage缓存生成一次commit，并加入commit历史 + * `git reset -- files` 撤销最后一次`git add files`，你也可以用`git reset` 撤销所有stage缓存文件 + * `git checkout -- files` 把文件从stage缓存复制到工作目录，用来丢弃本地修改 + +你可以用 `git reset -p`、`git checkout -p` 或 `git add -p`进入交互模式，也可以跳过stage缓存直接从commit历史取出文件或者直接提交代码。 +![enter image description here](http://marklodato.github.io/visual-git-guide/basic-usage-2.svg) + + * `git commit -a ` 相当于运行`git add`把所有当前目录下的文件加入stage缓存再运行`git commit`。 + * `git commit files` 进行一次包含最后一次提交加上工作目录中文件快照的提交，并且文件被添加到stage缓存。 + * `git checkout HEAD -- files` 回滚到复制最后一次提交。 + +约定 +-------- +后文中以下面的形式使用图片： +![enter image description here](http://marklodato.github.io/visual-git-guide/conventions.svg) +绿色的5位字符表示提交的ID，分别指向父节点。分支用橙色显示，分别指向特定的提交。当前分支由附在其上的_HEAD_标识。 + +这张图片里显示最后5次提交，_ed489_是最新提交。 _master_分支指向此次提交，另一个_maint_分支指向祖父提交节点。 + +命令详解 +--------- +### Diff + +有许多种方法查看两次提交之间的变动，下面是其中一些例子。 +![enter image description here](http://marklodato.github.io/visual-git-guide/diff.svg) + +### Commit + +提交时，git用stage缓存中的文件创建一个新的提交，并把此时的节点设为父节点。然后把当前分支指向新的提交节点。下图中，当前分支是_master_。 + +在运行命令之前，_master_指向_ed489_，提交后，_master_指向新的节点_f0cec_并以_ed489_作为父节点。 +![enter image description here](http://marklodato.github.io/visual-git-guide/commit-master.svg) +即便当前分支是某次提交的祖父节点，git会同样操作。下图中，在_master_分支的祖父节点_maint_分支进行一次提交，生成了_1800b_。 + +这样，_maint_分支就不再是_master_分支的祖父节点。此时，[merge](#merge) 或者 [rebase](#rebase) 是必须的。 +![enter image description here](http://marklodato.github.io/visual-git-guide/commit-maint.svg) +如果想更改一次提交，使用 `git commit --amend`。git会使用与当前提交相同的父节点进行一次新提交，旧的提交会被取消。 +![enter image description here](http://marklodato.github.io/visual-git-guide/commit-amend.svg) +另一个例子是[分离HEAD提交](#detached)，在后面的章节中介绍。 + +### Checkout + +checkout命令用于从历史提交（或者stage缓存）中拷贝文件到工作目录，也可用于切换分支。 + +当给定某个文件名（或者打开-p选项，或者文件名和-p选项同时打开）时，git会从指定的提交中拷贝文件到stage缓存和工作目录。比如，`git checkout HEAD~ foo.c`会将提交节点_HEAD~_（即当前提交节点的父节点）中的`foo.c`复制到工作目录并且加到stage缓存中。如果命令中没有指定提交节点，则会从stage缓存中拷贝内容。注意当前分支不会发生变化。 +![enter image description here](http://marklodato.github.io/visual-git-guide/checkout-files.svg) +当不指定文件名，而是给出一个（本地）分支时，那么_HEAD_标识会移动到那个分支（也就是说，我们“切换”到那个分支了），然后stage缓存和工作目录中的内容会和_HEAD_对应的提交节点一致。新提交节点（下图中的a47c3）中的所有文件都会被复制（到stage缓存和工作目录中）；只存在于老的提交节点（ed489）中的文件会被删除；不属于上述两者的文件会被忽略，不受影响。 +![enter image description here](http://marklodato.github.io/visual-git-guide/checkout-branch.svg) +如果既没有指定文件名，也没有指定分支名，而是一个标签、远程分支、SHA-1值或者是像_master~3_类似的东西，就得到一个匿名分支，称作_detached HEAD_（被分离的_HEAD_标识）。这样可以很方便地在历史版本之间互相切换。比如说你想要编译1.6.6.1版本的git，你可以运行`git checkout v1.6.6.1`（这是一个标签，而非分支名），编译，安装，然后切换回另一个分支，比如说`git checkout master`。然而，当提交操作涉及到“分离的HEAD”时，其行为会略有不同，详情见在[下面](#detached)。 +![enter image description here](http://marklodato.github.io/visual-git-guide/checkout-detached.svg) + +### HEAD标识处于分离状态时的提交操作 + +当_HEAD_处于分离状态（不依附于任一分支）时，提交操作可以正常进行，但是不会更新任何已命名的分支。你可以认为这是在更新一个匿名分支。 +![enter image description here](http://marklodato.github.io/visual-git-guide/commit-detached.svg) +一旦此后你切换到别的分支，比如说_master_，那么这个提交节点（可能）再也不会被引用到，然后就会被丢弃掉了。注意这个命令之后就不会有东西引用_2eecb_。 +![enter image description here](http://marklodato.github.io/visual-git-guide/checkout-after-detached.svg) +但是，如果你想保存这个状态，可以用命令`git checkout -b name`来创建一个新的分支。 +![enter image description here](http://marklodato.github.io/visual-git-guide/checkout-b-detached.svg) + +### Reset + +reset命令把当前分支指向另一个位置，并且有选择的变动工作目录和索引。也用来在从历史commit历史中复制文件到索引，而不动工作目录。 + +如果不给选项，那么当前分支指向到那个提交。如果用`--hard`选项，那么工作目录也更新，如果用`--soft`选项，那么都不变。 +![enter image description here](http://marklodato.github.io/visual-git-guide/reset-commit.svg) +如果没有给出提交点的版本号，那么默认用_HEAD_。这样，分支指向不变，但是索引会回滚到最后一次提交，如果用`--hard`选项，工作目录也同样。 +![enter image description here](http://marklodato.github.io/visual-git-guide/reset.svg) +如果给了文件名(或者 `-p`选项), 那么工作效果和带文件名的[checkout](#checkout)差不多，除了索引被更新。 +![enter image description here](http://marklodato.github.io/visual-git-guide/reset-files.svg) + +### Merge + +merge 命令把不同分支合并起来。合并前，索引必须和当前提交相同。如果另一个分支是当前提交的祖父节点，那么合并命令将什么也不做。 + +另一种情况是如果当前提交是另一个分支的祖父节点，就导致_fast-forward_合并。指向只是简单的移动，并生成一个新的提交。 +![enter image description here](http://marklodato.github.io/visual-git-guide/merge-ff.svg) +否则就是一次真正的合并。默认把当前提交(_ed489_ 如下所示)和另一个提交(_33104_)以及他们的共同祖父节点(_b325c_)进行一次[三方合并](http://en.wikipedia.org/wiki/Three-way_merge)。结果是先保存当前目录和索引，然后和父节点_33104_一起做一次新提交。 +![enter image description here](http://marklodato.github.io/visual-git-guide/merge.svg) + +### Cherry Pick + +cherry-pick命令"复制"一个提交节点并在当前分支做一次完全一样的新提交。 +![enter image description here](http://marklodato.github.io/visual-git-guide/cherry-pick.svg) + +### Rebase + +rebase是合并命令的另一种选择。合并把两个父分支合并进行一次提交，提交历史不是线性的。rebase在当前分支上重演另一个分支的历史，提交历史是线性的。 + +本质上，这是线性化的自动的 [cherry-pick](#cherry-pick)。 +![enter image description here](http://marklodato.github.io/visual-git-guide/rebase.svg) +上面的命令都在_topic_分支中进行，而不是_master_分支，在_master_分支上重演，并且把分支指向新的节点。注意旧提交没有被引用，将被回收。 + +要限制回滚范围，使用`--onto`选项。下面的命令在_master_分支上重演当前分支从_169a6_以来的最近几个提交，即_2c33a_。 +![enter image description here](http://marklodato.github.io/visual-git-guide/rebase-onto.svg) + +同样有`git rebase --interactive`让你更方便的完成一些复杂操作，比如丢弃、重排、修改、合并提交。