读懂diff命令

diff是Unix系统的一个很重要的工具程序。git

它用来比较两个文本文件的差别,是代码版本管理的基石之一。你在命令行下,输入:shell

1
  $ diff < 变更前的文件 > < 变更后的文件 >;

diff就会告诉你,这两个文件有何差别。它的显示结果不太好懂,下面我就来讲明,如何读懂diff。app

阮一峰:读懂 diff

1、diff的三种格式工具

因为历史缘由,diff有三种格式:spa

* 正常格式(normal diff)命令行

* 上下文格式(context diff)code

* 合并格式(unified diff)orm

咱们依次来看。对象

2、示例文件ip

为了便于讲解,先新建两个示例文件。

第一个文件叫作f1,内容是每行一个a,一共7行。

a

a

a

a

a

a

a

第二个文件叫作f2,修改f1而成,第4行变成b,其余不变。

a

a

a

b

a

a

a

3、正常格式的diff

如今对f1和f2进行比较:

1
$ diff    f1   f2

这时,diff就会显示正常格式的结果:

4c4

< a   

—   

> b

第一行是一个提示,用来讲明变更位置。

4c4

它分红三个部分:前面的”4″,表示f1的第4行有变化;中间的”c”表示变更的模式是内容改变(change),其余模式还有”增长”(a,表明addition)和”删除”(d,表明deletion);后面的”4″,表示变更后变成f2的第4行。

第二行分红两个部分。

< a

前面的小于号,表示要从f1当中去除该行(也就是第4行),后面的”a”表示该行的内容。 第三行用来分割f1和f2。

第四行,相似于第二行。

> b

前面的大于号表示f2增长了该行,后面的”b”表示该行的内容。

最先的Unix(即AT&T版本的Unix),使用的就是这种格式的diff。

4、上下文格式的diff

上个世纪80年代初,加州大学伯克利分校推出BSD版本的Unix时,以为diff的显示结果太简单,最好加入上下文,便于了解发生的变更。所以,推出了上下文格式的diff。

它的使用方法是加入c参数(表明context)。

1
$ diff    -c    f1    f2

显示结果以下:

*** f1 2012-08-29 16:45:41.000000000 +0800

— f2 2012-08-29 16:45:51.000000000 +0800

***************

*** 1,7 ****

a

a

a

!a

a

a

a

— 1,7 —-

a

a

a

!b

a

a

a

这个结果分红四个部分。

第一部分的两行,显示两个文件的基本状况:文件名和时间信息。

*** f1 2012-08-29 16:45:41.000000000 +0800

— f2 2012-08-29 16:45:51.000000000 +0800

“***”表示变更前的文件,”—”表示变更后的文件。

第二部分是15个星号,将文件的基本状况与变更内容分割开。

***************

第三部分显示变更前的文件,即f1。

*** 1,7 ****

a

a

a

!a

a

a

a

这时不只显示发生变化的第4行,还显示第4行的前面三行和后面三行,所以一共显示7行。因此,前面的”*** 1,7 ****”就表示,从第1行开始连续7行。

另外,文件内容的每一行最前面,还有一个标记位。若是为空,表示该行无变化;若是是感叹号(!),表示该行有改动;若是是减号(-),表示该行被删除若是是加号(+),表示该行为新增

第四部分显示变更后的文件,即f2。

— 1,7 —-

a

a

a

!b

a

a

a

除了变更行(第4行)之外,也是上下文各显示三行,总共显示7行。

5、合并格式的diff

若是两个文件类似度很高,那么上下文格式的diff,将显示大量重复的内容,很浪费空间。1990年,GNU diff率先推出了”合并格式”的diff,将f1和f2的上下文合并在一块儿显示。

它的使用方法是加入u参数(表明unified)。

1
$diff  -u   f1   f2

显示结果以下:

— f1 2012-08-29 16:45:41.000000000 +0800

+++ f2 2012-08-29 16:45:51.000000000 +0800

@@ -1,7 +1,7 @@

a

a

a

-a

+b

a

a

a

它的第一部分,也是文件的基本信息。

— f1 2012-08-29 16:45:41.000000000 +0800

+++ f2 2012-08-29 16:45:51.000000000 +0800

“—”表示变更前的文件,”+++”表示变更后的文件。

第二部分,变更的位置用两个@做为起首和结束。

@@ -1,7 +1,7 @@

前面的”-1,7″分红三个部分:减号表示第一个文件(即f1),”1″表示第1行,”7″表示连续7行(注意不是第7行)合在一块儿,就表示下面是第一个文件从第1行开始的连续7行。一样的,”+1,7″表示变更后,成为第二个文件从第1行开始的连续7行。

第三部分是变更的具体内容。

a

a

a

-a

+b

a

a

a

除了有变更的那些行之外,也是上下文各显示3行。它将两个文件的上下文,合并显示在一块儿,因此叫作”合并格式”。每一行最前面的标志位,空表示无变更,减号表示第一个文件删除的行,加号表示第二个文件新增的行。

6、git格式的diff

版本管理系统git,使用的是合并格式diff的变体。

$ git diff

显示结果以下:

diff –git a/f1 b/f1

index 6f8a38c..449b072 100644

— a/f1

+++ b/f1

@@ -1,7 +1,7 @@

a

a

a

-a

+b

a

a

a

第一行表示结果为git格式的diff。

1
diff   --git a /f1  b /f1

进行比较的是,a版本的f1(即变更前)和b版本的f1(即变更后)。

第二行表示两个版本的git哈希值(index区域的6f8a38c对象,与工做目录区域的449b072对象进行比较),最后的六位数字是对象的模式(普通文件,644权限)。

index 6f8a38c..449b072 100644

第三行表示进行比较的两个文件。

— a/f1

+++ b/f1

“—”表示变更前的版本,”+++”表示变更后的版本。

后面的行都与官方的合并格式diff相同。

@@ -1,7 +1,7 @@

a

a

a

-a

+b

a

a

a

7、阅读材料

diff – Wikipedia

How to read a patch or diff

How to work with diff representation in git

(完)