读懂diff

Posted 2020-10-25 dion至君

 

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