读懂diff


diff是UNIX系统下很重要的工具程序。diff 命令比较文本文件。它能比较单个文件或者目录内容,一般用于版本控制,可以比较两个版本间的代码差异,并制作成补丁文件。

diff命令时代码版本管理的基石之一。我们可以在命令行下,输入:

$ diff <变动前的文件> <变动后的文件>

  然后diff命令会自动执行比较,显示出两个文件不同的部分。例如:

一、diff有三种格式

    * 正常格式(normal diff)

  * 上下文格式(context diff)

  * 合并格式(unified diff)

我们使用两个例子

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

  a
  a
  a
  a
  a
  a
  a

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

  a
  a
  a
  b
  a
  a
  a

三、正常格式的diff

我们比较下两个文件。

 $ diff f1 f2

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

   4c4
  < a
  ---
  > b

  第一行是一个提示,用来说明变动位置。它分成三个部分:前面的"4",表示f1的第4行有变化;中间的"c"表示变动的模式是内容改变(change),其他模式还有"增加"(a,代表addition)和"删除"(d,代表deletion);后面的"4",表示变动后变成f2的第4行

四、上下文格式的diff

上下文格式的diff,它的使用方法是加入c参数(代表context)。是上个世纪80年代加州大学伯里克分校推出的。

$ 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

五、合并格式的diff

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

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

$ 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行。合在一起,就表示下面是第一个文件从第1行开始的连续7行。同样的,"+1,7"表示变动后,成为第二个文件从第1行开始的连续7行。

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

   a
   a
   a
  -a
  +b
   a
   a
   a

除了有变动的那些行以外,也是上下文各显示3行。它将两个文件的上下文,合并显示在一起,所以叫做"合并格式"。每一行最前面的标志位,空表示无变动,减号表示第一个文件删除的行,加号表示第二个文件新增的行。

六、git格式的diff

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

七、参考资料:

  * diff - Wikipedia

  * How to read a patch or diff

  * How to work with diff representation in git

       *读懂diff