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
现在对f1和f2进行比较:
$ 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。
四、上下文格式的diff
上个世纪80年代初,加州大学伯克利分校推出BSD版本的Unix时,觉得diff的显示结果太简单,最好加入上下文,便于了解发生的变动。因此,推出了上下文格式的diff。
它的使用方法是加入c参数(代表context)。
$ 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行。
五、合并格式的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的变体。
$ 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。
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
七、阅读材料
* How to work with diff representation in git
(完)
JaySoon 说:
我一般用vimdiff,显示的比较直观
2012年8月29日 19:55 | # | 引用
Nicky 说:
me too
2012年8月29日 20:46 | # | 引用
redraiment 说:
我一般喜欢 Emacs 的 Ediff
2012年8月30日 07:26 | # | 引用
welkin 说:
请问,为什么google订阅会出现“抱歉,发生意外情况,阻碍了 Google 阅读器完成请求。”,订阅其他网站正常。有什么办法解决吗
2012年8月30日 09:05 | # | 引用
Eric.Wei 说:
一直用vimdiff,阮老师的这篇文章让我对diff有了更全面更深入的理解,表示学习的很愉快~
2012年8月30日 09:08 | # | 引用
无忌 说:
可以改用有道订阅,reader.youdao.com 以前也是用google但感觉总是不稳定
2012年8月30日 09:32 | # | 引用
Jam 说:
你网页没有使用等宽字体吧?或是你CSS声明时的字体用的是Windows上的字体。我一般使用DejaVu Sans Mono。
并且空格和TAB显示时都没有了是不是?
2012年8月30日 09:39 | # | 引用
zhaoyou 说:
把 url里面的 http 改成 https 就可以了。
2012年8月30日 09:40 | # | 引用
liancheng 说:
阮老师,烦请在正文的代码段上应用等宽字体吧。注意到您在评论输入框内都用上等宽字体了 :-)
2012年8月30日 10:25 | # | 引用
阮一峰 说:
谢谢建议。真是令人汗颜,我居然一直没想过在CSS里加入等宽字体……
刚刚已经将所有的引用段,都改成Courier New字体了。
2012年8月30日 11:22 | # | 引用
judezhan 说:
推荐神器一枚:meld
2012年8月30日 11:56 | # | 引用
beikel 说:
我一般都是git diff | kompare - 或者svn diff | kompare -
2012年8月30日 13:56 | # | 引用
Holy俊杰 说:
把`git diff`的结果打成一个patch,然后在其他地方打上这个patch:
$ git diff --no-color > saved.patch
$ patch -p1 $lt; saved.patch
2012年8月30日 14:04 | # | 引用
Aaron Zhou 说:
简明易懂,图文结合,喜欢~
果断mark学习
2012年8月30日 14:48 | # | 引用
colin 说:
配图是什么软件,好像很有特色
2012年8月30日 22:19 | # | 引用
0x12F34CD 说:
看diff最好还是用GUI。
2012年8月31日 04:24 | # | 引用
ET 说:
哈,对diff讲得通俗易懂啊~
2012年8月31日 12:47 | # | 引用
王登武 说:
我使用图形化的kompare做,无论是diff -c 还是diff -u还是svn diff 都可以很好的支持,图形化一目了然,还有不同颜色的显示,大家可以试试
2012年8月31日 13:40 | # | 引用
richard zeng 说:
这个Kompare界面非常漂亮直观,能用在Windows 下吗
2012年8月31日 16:58 | # | 引用
蓝色行星 说:
一直订阅您的博客,学习了很多东西,非常感谢。
本文中对于git中文件的说明似乎有些偏差。
100644在git中的意思应该是表示这是一个“普通文件”
其他还有,
100755 表示可执行文件
120000 表示符号链接
参考下列资料
http://progit.redhome.cc/book/zh/ch9-2.html
2012年9月 1日 13:18 | # | 引用
小P孩儿 说:
阮老师,你不是在每篇文章的最后都留有展示广告(即购买广告位)的地方吗,那为什么还要在feed中加一个广告呢(在google reader中就在每篇文章的最后又多了一个广告条)我很不喜欢在feed中也这样做
2012年9月 2日 12:44 | # | 引用
阮一峰 说:
我记得,第1位和第2位表示文件类型,第3位表示set-uid/set-gid/sticky bits,第4、5、6位表示文件权限。参见http://goo.gl/nXtSE
所以我的原文应该没错,跟Pro Git不冲突。
2012年9月 2日 20:34 | # | 引用
阮一峰 说:
我只在Feed的结尾加了一行字,想看看效果。
总的来说,我觉得不影响读者体验。还希望各位多多谅解。
2012年9月 2日 20:38 | # | 引用
DouO 说:
用 https 协议
2012年9月 4日 09:44 | # | 引用
蓝色行星 说:
原来是这样,学习了!非常感谢!
2012年9月 4日 17:36 | # | 引用
六翼 说:
Windows下TotalCmd是好几个小工具方面的神器,文件比较/文件夹同步就是其中之一
2012年9月10日 08:51 | # | 引用
Andrew 说:
单击 Google Reader 左上方 Logo 下面的 Subscribe,在弹出的方框里填上本网址即可。
2012年9月13日 14:00 | # | 引用
atom 说:
不用meld,不敢读diff。
2012年9月17日 18:27 | # | 引用
yummy 说:
请问配图是什么软件的截图呢?很直观
2012年9月26日 22:05 | # | 引用
raven 说:
你们俩都不知道https么?
2012年10月 7日 20:53 | # | 引用
烤全羊 说:
“除了有变动的那些行以外,也是上下文各显示3行。它将两个文件的上下文,合并显示在一起,所以叫做"合并格式"。每一行最前面的标志位,空表示无变动,减号表示第一个文件删除的行,加号表示第二个文件新增的行。”
这里的描述不是很准确,减号表示第一个版本相对于第二个版本不同的行,加号表示第二个版本相对于第一个版本不同的行
2012年10月31日 10:50 | # | 引用
徐牛 说:
@烤全羊:
看了之后我也有点疑惑,如果是第二个版本删除了一行怎么显示呢。如此说就明了很多了。
2012年12月 8日 23:16 | # | 引用
小码哥 说:
2013年3月 2日 19:43 | # | 引用
鑫HonestManXin 说:
diff的上下文模式的输出第三部分和第四部分指出变更位置的输出
*** 1,7 ****该解释应该是第一行到第七行
而合并格式的解释才是从第一行开始的连续七行
2013年3月 3日 21:25 | # | 引用
猪头 说:
请问,智商低又对编程感兴趣怎么办?
2013年3月22日 06:19 | # | 引用
localtest 说:
赞一个,这个工具原来这么简单,以前对Linux老是有点畏惧的感觉,现在越来越放得开了
2013年5月13日 22:25 | # | 引用
randy 说:
windows下面用的是Winmerge,LINUX下面用的就是DIFF,之前没怎么详细的了解,看了博文受益匪浅
2014年3月 2日 14:54 | # | 引用
仙人球 说:
每次看到头皮发麻的东西,到你这来一下就轻松了
2014年5月30日 16:13 | # | 引用
袁源 说:
额,看完了。原来这么通俗的东西也要讲一篇文章。
不过还是感谢阮一峰老师,尤其是对我没见过的东西进行科普的那些文章,我觉得真是太好懂太受益了。
2014年12月29日 20:57 | # | 引用
wenmin92 说:
讲的太棒了. 看了好几篇, 排版, 内容, 都是最佳, 大赞!
2016年6月 9日 18:50 | # | 引用
享大利 说:
写得好清楚,感谢作者分享。
2016年6月17日 10:27 | # | 引用
bcn 说:
专门来点个赞!正发愁看不懂diff内容呢,非常感谢!!!
2016年6月25日 00:24 | # | 引用
nervalpoet 说:
好文章 希望阮老师多写些文章 分享心得见地 难得的很。。。。
2017年2月16日 15:50 | # | 引用
胡鑫龙 说:
捉个虫。
我在自己系统上测试了一下,发现关于-c参数,即上下文的那一节描述有误。
文中说:
前面的"*** 1,7 ****"就表示,从第1行开始连续7行
其实应该是:
从第1行开始到第7行
因为阮老师的例子,a,b两个文件都是正好7行的,所以才会发生这种误解,我
自己的例子是11行,显示的是5,11,前三行后三行再加上修改的一行一共是7行。
2017年5月31日 16:10 | # | 引用
阿姚 说:
好文章 希望阮老师多写些文章 分享心得见地 难得的很。。。。
2018年9月19日 12:08 | # | 引用
aa 说:
好文章 希望阮老师多写些文章 分享心得见地 难得的很。。。。
2018年10月25日 19:47 | # | 引用
丢火车 说:
写的真好,追踪溯源。
2019年5月23日 09:38 | # | 引用
stem 说:
好文需要回头看
2019年7月10日 10:37 | # | 引用
菜鸟一个 说:
简单明了,大爱楼主
2020年9月18日 00:01 | # | 引用
shawn 说:
今天读起来,回味无穷,犹如吃烤全羊
2021年8月 7日 07:54 | # | 引用
healthsgood 说:
第二次阅读,豁然开朗。
以前把它想得太复杂了,其实diff的结果所包含的信息就那么点东西,没有那么绕。
比如,删除符号一定出现在第一个文件上,增加符号一定出现在第二个文件上。
2022年2月28日 17:07 | # | 引用