Git学习教程（七） Git差异比对

第七课 Git差异比对

内容提要：显示项目的两个不同版本之间的差异，或者显示指定文件的不同之处

在‘git日志’一课中，我们通过'git log -p'命令来显示每一次提交与其父节点提交内容之间快照的差异。这节课介绍的'diff'命令会实现类似的功能---用一种统一的格式来显示两个快照或文件之间的差异。这节课就向你展示如何使用diff命令。
[align=left]查看变更还未载入(changed but unstaged)的文件比对[/align]
最常见的一种情况是使用'git diff'查看工作目录中某个还未载入（stage）的文件的差异。
实验方案：

1.修改一下simplegit.rb，添加一个方法
2.然后在README文件中添加一个作者
3.然后我们用'git add'命令把README文件载入(stage)
4.运行'git status'会显示README载入了，而simplegit.rb只是修改了还未载入。

$ vim lib/simplegit.rb
$ vim README
$ git add README
$ git status
# On branch master
# Changes to be committed:
# (use "git reset HEAD <file>..." to unstage)
#
# modified: README
#
# Changed but not updated:
# (use "git add <file>..." to update what will be committed)
# (use "git checkout -- <file>..." to discard changes in working directory)
#
# modified: lib/simplegit.rb
#
那么，我现在想查看一下对simplegit.rb文件究竟做了什么改动？在我载入之前怎么查看这些改动的内容呢？答案是只需运行不带任何参数的'git diff'命令即可：

$ git diff
diff --git a/lib/simplegit.rb b/lib/simplegit.rb
index dd5ecc4..8ac6604 100644
--- a/lib/simplegit.rb
+++ b/lib/simplegit.rb
@@ -25,6 +25,10 @@ class SimpleGit
command("git log -n 25 #{treeish}")
end
+ def log_single(branch = 'master')
+ command("git log --pretty=oneline #{branch}")
+ end
+
def blame(path)
command("git blame #{path}")
end

这样就可以看到我添加到文件中的内容，现在我可以决定是不是要将其载入了。注意，README文件的修改并没有显示出来。

查看载入（stage）而并未提交（commit）的变更
为了查看载入（staged）而并未提交（not committed）的内容差异，可以使用'git diff --stage'命令（在git 1.6之前的版本中，使用'--cached'）

$ git diff --staged
diff --git a/README b/README
index c526f88..879f0d4 100644
--- a/README
+++ b/README
@@ -8,3 +8,4 @@ It is an example for the Git Peepcode book that I'm currently writin
Author : Scott Chacon (schacon@gmail.com)
Orange Peel Chacon (opchacon@gmail.com)
Magnus O. Chacon (mchacon@gmail.com)
+ Josephine Chacon (jo.chacon@gmail.com)
适应情形：在运行git commit（不带'-a'）之前，查看所有载入而未提交的变更内容。

查看在最后一次提交之后的所有变更
现在，如果你想查看最后一次提交之后工作目录中文件的变更，你可以在git diff之后加一个HEAD来进行比对：
$ git diff HEAD
diff --git a/README b/README
index c526f88..879f0d4 100644
--- a/README
+++ b/README
@@ -8,3 +8,4 @@ It is an example for the Git Peepcode book that I'm currently writin
Author : Scott Chacon (schacon@gmail.com)
Orange Peel Chacon (opchacon@gmail.com)
Magnus O. Chacon (mchacon@gmail.com)
+ Josephine Chacon (jo.chacon@gmail.com)
diff --git a/lib/simplegit.rb b/lib/simplegit.rb
index dd5ecc4..8ac6604 100644
--- a/lib/simplegit.rb
+++ b/lib/simplegit.rb
@@ -25,6 +25,10 @@ class SimpleGit
command("git log -n 25 #{treeish}")
end
+ def log_single(branch = 'master')
+ command("git log --pretty=oneline #{branch}")
+ end
+
def blame(path)
command("git blame #{path}")
end
适用情形：在运行'git commit -a'之前。显示所有载入的和未载入的变更。

在本教程的'intermediate'一课中会详细讲述HEAD在git中的含义。在这里要注意的一点是，HEAD的含义跟SVN中的HEAD含义大不相同，在git中HEAD与你目前所处分枝的最后一次提交相关。与每个用户的本地仓库相关，在不同分枝间切换时它也会发生改变。
上面是使用'diff'时最常用的三条命令。

从一个特定点开始文件的修改情况
这也是最常见的一个问题。譬如，如何查看创建v1.6这个标签之后README文件所发生的修改呢，可以这样：

$ git diff v1.6.0 -- README
diff --git a/README b/README
index 548142c..5fa41b7 100644
--- a/README
+++ b/README
@@ -24,7 +24,7 @@ It was originally written by Linus Torvalds with help of a group o
hackers around the net. It is currently maintained by Junio C Hamano.
Please read the file INSTALL for installation instructions.
-See Documentation/tutorial.txt to get started, then see
+See Documentation/gittutorial.txt to get started, then see
Documentation/everyday.txt for a useful minimum set of commands,
and "man git-commandname" for documentation of each command.
上面就显示出了工作目录中README文件的版本差异--如果你做了本地修改，载入或未载入，都会在这次比对中显示出来。

两次提交的差异比对
如果你想对两次快照做差异比对，也即项目的两个版本之间比对--直接在git diff后跟上要比对的两个版本号即可：

$ git diff v1.0 v1.1如果这两个版本分别在两个目录中的话，直接运行unix的'diff'工具进行比对也可以。
上节课在介绍log命令时讲过格式化参数，譬如-stat，在这里也可以对git diff命令加这样的参数，显示某些统计数，下面是显示v1.6.1.1和v1.6.1.2两个版本之间差异的统计数字：

$ git diff v1.6.1.1 v1.6.1.2 --stat
Documentation/RelNotes-1.6.1.2.txt | 39 +++++++++++++
Documentation/config.txt | 4 +-
Documentation/git-ls-tree.txt | 8 +++-
GIT-VERSION-GEN | 2 +-
RelNotes | 2 +-
builtin-commit.c | 6 ++
builtin-gc.c | 8 ++-
builtin-grep.c | 15 +++++-
builtin-log.c | 28 +++++++++-
builtin-ls-tree.c | 7 ++-
builtin-send-pack.c | 43 +++++++--------
diffcore-rename.c | 9 +++-
git-sh-setup.sh | 2 +-
sha1_file.c | 3 +-
sha1_name.c | 2 +-
t/t2300-cd-to-toplevel.sh | 4 +-
t/t4014-format-patch.sh | 52 +++++++++++++++++-
t/t5519-push-alternates.sh | 106 ++++++++++++++++++++++++++++++++++++
t/t7002-grep.sh | 7 +++
test-path-utils.c | 2 +-
20 files changed, 306 insertions(+), 43 deletions(-)

还可以深入查看某个具体文件的变更比对：

$ git diff v1.6.1.1 v1.6.1.2 -- sha1_file.c
diff --git a/sha1_file.c b/sha1_file.c
index 52d1ead..ce5ea12 100644
--- a/sha1_file.c
+++ b/sha1_file.c
@@ -2337,7 +2337,8 @@ static int create_tmpfile(char *buffer, size_t bufsiz, const c
static int write_loose_object(const unsigned char *sha1, char *hdr, int hdrlen,
void *buf, unsigned long len, time_t mtime)
{
- int fd, size, ret;
+ int fd, ret;
+ size_t size;
unsigned char *compressed;
z_stream stream;
char *filename;

执行之后会显示sha1_file.c文件在v1.6.1.1和v1.6.1.2两个版本之间的比对结果。

在合并某分枝前查看变更内容
这是个比较奇怪的问题，因为如果你开始是工作在一个主分枝上，而后生成了两个分支，如果直接对比快照的话，结果只会显示从一个状态到另一个状态的差异比对结果。
举例来说，如果你创建了一个'dev'的分枝，进入这个分枝给lib/simplegit.rb添加了一个函数，然后回到了'master'分枝，删除了README文件的一行，然后运行：

$ git diff master dev
结果会显示你给某个文件中添加了方法，还往README文件添加了一行内容。为什么会这样？因为对'dev'分枝来说，README文件还是原样，而在'master'上，你已经删掉了一行，这样直接对两个快照进行对比就好似'dev'分枝添加了一行进去一样。你想查看的实际上是在创建dev分枝之后在这条分枝上的差异对比，所以应该执行这样的命令：

$ git diff master...dev
这就不会拿master分枝上最后一个快照和dev分枝上最后一个快照进行比对--而是用dev与master所交的那个分歧点和现在的dev分枝上最后一个快照进行比对。在我们这个例子中，这样比对的结果是显示对那个文件添加了一个函数。如果你目前正处在master分枝上，你可以运行：

[align=left]$ git diff ...dev[/align]
跟上面的结果是一样的。所以，如果你想查看将要合并的某个分枝会有什么样的变化，可以执行：

$ git diff ...(branch)
将branch替换为你想要合并的分枝名即可。