第七课 Git差异比对

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

在‘git日志’一课中，我们通过'git log -p'命令来显示每一次提交与其父节点提交内容之间快照的差异。这节课介绍的'diff'命令会实现类似的功能---用一种统一的格式来显示两个快照或文件之间的差异。这节课就向你展示如何使用diff命令。

查看变更还未载入(changed but unstaged)的文件比对

最常见的一种情况是使用'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 ..." to unstage)
#
# modified:   README
#
# Changed but not updated:
#   (use "git add ..." to update what will be committed)
#   (use "git checkout -- ..." 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 ()
          Orange Peel Chacon ()
          Magnus O. Chacon ()
+         Josephine Chacon ()

适应情形：在运行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 ()
          Orange Peel Chacon ()
          Magnus O. Chacon ()
+         Josephine Chacon ()
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 -- 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分枝上，你可以运行：

$ git diff ...dev

跟上面的结果是一样的。所以，如果你想查看将要合并的某个分枝会有什么样的变化，可以执行：

$ git diff ...(branch)

将branch替换为你想要合并的分枝名即可。