读懂diff(转载)

本文转载于:http://www.ruanyifeng.com/blog/2012/08/how_to_read_diff.html 版权全部归原做者

1. 前言

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

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

　　　　

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

　　　　

 

2. diff的三种格式

　　因为历史缘由，diff有三种格式：

　　　　

　　咱们依次来看。

 

3. 示例文件

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

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

　　　　

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

　　　　

 

4. 正常格式的diff

　　如今对f1和f2进行比较：

　　　　

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

　　　　

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

　　　　

　　它分红三个部分：前面的"4"，表示f1的第4行有变化；中间的"c"表示变更的模式是内容改变（change），其余模式还有"增长"（a，表明addition）和"删除"（d，表明deletion）；后面的"4"，表示变更后变成f2的第4行。

　　第二行分红两个部分。

　　　　

　　前面的小于号，表示要从f1当中去除该行（也就是第4行），后面的"a"表示该行的内容。

　　第三行用来分割f1和f2。

　　　　

　　第四行，相似于第二行。

　　　　

　　前面的大于号表示f2增长了该行，后面的"b"表示该行的内容。最先的Unix（即AT&T版本的Unix），使用的就是这种格式的diff。

 

5. 上下文格式的diff

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

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

　　　　

　　显示结果以下：

　　　　

　　这个结果分红四个部分。

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

　　　  

　　"***"表示变更前的文件，"---"表示变更后的文件。

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

　　　  

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

　　　   

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

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

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

　　　  

　　除了变更行（第4行）之外，也是上下文各显示三行，总共显示7行。

 

6. 合并格式的diff

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

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

　　    

　　显示结果以下：

　　　　

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

　　　　

　　"---"表示变更前的文件，"+++"表示变更后的文件。

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

　　　　

　　前面的"-1,7"分红三个部分：减号表示第一个文件（即f1），"1"表示第1行，"7"表示连续7行。合在一块儿，就表示下面是第一个文件从第1行开始的连续7行。一样的，"+1,7"表示变更后，成为第二个文件从第1行开始的连续7行。

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

　　　　

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

 

7. git格式的diff

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

　　　　

　　显示结果以下：

　　　　

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

　　　　

 

　　进行比较的是，a版本的f1（即变更前）和b版本的f1（即变更后）。

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

　　　　

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

　　　　

　　"---"表示变更前的版本，"+++"表示变更后的版本。

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

　　　　

 

8. 阅读材料

　　* diff - Wikipedia

　　* How to read a patch or diff

　　* How to work with diff representation in git