返回列表

diff和patch工具

默认分类 2016/03/22 20:14

转载自:https://orzfly.com/html/diff-and-patch-and-windows.html

diff 和 patch 的入门(及 Windows 下的用法)

自从我开始使用 Git 以及接触 Linux 之后,我发现我越来越离不开 Linux 上那些方便好用的工具。比如 diff & patch,相对于 Windows 自带的 fc 要好用太多太多。

除 Windows 部分外,本文目前的多数内容是对补丁(patch)的制作与应用的修正、整理、简化与重新排版。

如果修改了开源代码,为了方便分享(如提交漏洞)或自己留存使用,一般都要制作一个补丁。在从源码安装软件时,也难免要应用些别人做好的补丁,本文介绍如何制作和应用补丁。

diff 简介

diff 可以比较两个东西,并可同时记录下二者的区别。制作补丁时的一般用法和常见选项为:

$ diff 【选项】 源文件(夹) 目的文件(夹)
-r
递归。设置后 diff 会将两个不同版本源代码目录中的所有对应文件全部都进行一次比较,包括子目录文件。
-N
选项确保补丁文件将正确地处理已经创建或删除文件的情况。
-u
输出每个修改前后的 3 行,也可以用 `-u5` 等指定输出更多上下文。
-E, -b, -w, -B, --strip-trailing-cr
忽略各种空白,可参见文档,按需选用。

patch 简介

patch的作用则是将 diff 记录的结果(即补丁)应用到相应文件(夹)上。最常见的用法为:

$ patch -pNUM < patchfile 
-p Num
忽略几层文件夹,随后详解。
-E
选项说明如果发现了空文件,那么就删除它。
-R
取消打过的补丁。

为了解释 -p 参数,需要看看如下 patch 文件片段:

--- old/modules/pcitable Mon Sep 27 11:03:56 1999
+++ new/modules/pcitable Tue Dec 19 20:05:41 2000

如果使用参数 -p0,那就表示从当前目录找一个叫做 old 的文件夹,再在它下面寻找modules/pcitable 文件来执行 patch 操作。

而如果使用参数 -p1,那就表示忽略第一层目录(即不管 old ),从当前目录寻找 modules 的文件夹,再在它下面找 pcitable。

简单应用

利用以上命令,处理单个文件补丁的方法:

# 产生补丁 
$ diff -uN original new &gt; patch 
# 打补丁 
$ patch -p0 < patch 
# 取消补丁 
$ patch -RE -p0 < patch 

对整个文件夹打补丁的情况:

# 产生补丁 
$ diff -uNr original new &gt; patch 
# 打补丁 
$ cd original 
$ patch -p1 < patch 
# 取消补丁 
$ patch -R -p1 < patch 

另外,使用版本控制工具时,可以直接用 svn diff 或 git diff 生成补丁文件。

值得一提的是,由于应用补丁时的目标代码和生成补丁时的代码未必相同,打补丁操作可能失败。补丁失败的文件会以.rej结尾,下面命令可以找出所有rej文件:

$ find . -name '*.rej'

patch 文件构成

补丁文件里到底存储了哪些信息呢?看看这个例子:

--- test0 2006-08-18 09:12:01.000000000 +0800
+++ test1 2006-08-18 09:13:09.000000000 +0800
@@ -1,3 +1,4 @@ 
+222222 
111111 
-111111 
+222222 
111111 
补丁头
补丁头是分别由 ---/+++ 开头的两行,用来表示要打补丁的文件。--- 开头表示旧文件,+++ 开头表示新文件。
一个补丁文件中的多个补丁
一个补丁文件中可能包含以 ---/+++ 开头的很多节,每一节用来打一个补丁。所以在一个补丁文件中可以包含好多个补丁。
块是补丁中要修改的地方。它通常由一部分不用修改的东西开始和结束。他们只是用来表示要修改的位置。他们通常以 @@ 开始,结束于另一个块的开始或者一个新的补丁头。
块的缩进
块会缩进一列,而这一列是用来表示这一行是要增加还是要删除的。
块的第一列
+ 号表示这一行是要加上的。- 号表示这一行是要删除的。没有加号也没有减号表示这里只是引用的而不需要修改。

单文件实例分析

设当前目录有文件 test0

111111 
111111 
111111 

和文件 test1

222222 
111111 
222222 
111111 

使用 diff 创建补丁 test1.patch

$ diff -uN test0 test1 &gt; test1.patch 

因为是单个文件,故不需要 -r 选项。此命令得到如下补丁:

--- test0 2006-08-18 09:12:01.000000000 +0800
+++ test1 2006-08-18 09:13:09.000000000 +0800
@@ -1,3 +1,4 @@ 
+222222 
111111 
-111111 
+222222 
111111 

要应用补丁,只需:

$ patch -p0 < test1.patch 
patching file test0 

此时 test0 就和 test1 一样了。

如果要取消补丁做出的更改,恢复旧版本:

$ patch -RE -p0 < test1.patch 
patching file test0 

文件夹实例分析

设有如下环境:

--prj0/ 
test0 
prj0name 
--prj1/ 
test1 
prj1name 

prj0/prj0name内容为如下三行:

-------- 
prj0/prj0name 
-------- 

prj1/prj1name内容为如下三行:

-------- 
prj1/prj1name 
-------- 

用 diff -uNr 创建补丁:

$ diff -uNr prj0 prj1 &gt; prj1.patch 

得到的patch文件为:

diff -uNr prj0/prj0name prj1/prj0name 
--- prj0/prj0name 2006-08-18 09:25:11.000000000 +0800 
+++ prj1/prj0name 1970-01-01 08:00:00.000000000 +0800 
@@ -1,3 +0,0 @@ 
--------- 
-prj0/prj0name 
--------- 
diff -uNr prj0/prj1name prj1/prj1name 
--- prj0/prj1name 1970-01-01 08:00:00.000000000 +0800 
+++ prj1/prj1name 2006-08-18 09:26:36.000000000 +0800 
@@ -0,0 +1,3 @@ 
+--------- 
+prj1/prj1name 
+--------- 
diff -uNr prj0/test0 prj1/test0 
--- prj0/test0 2006-08-18 09:23:53.000000000 +0800
+++ prj1/test0 1970-01-01 08:00:00.000000000 +0800
@@ -1,3 +0,0 @@ 
-111111 
-111111 
-111111 
diff -uNr prj0/test1 prj1/test1 
--- prj0/test1 1970-01-01 08:00:00.000000000 +0800
+++ prj1/test1 2006-08-18 09:26:00.000000000 +0800
@@ -0,0 +1,4 @@ 
+222222 
+111111 
+222222 
+111111 

如果要应用此补丁,则:

$ ls 
prj0 prj1 prj1.patch 
$ cd prj0 
$ patch -p1 < ../prj1.patch 
patching file prj0name 
patching file prj1name 
patching file test0 
patching file test1 

此时可用 ls 看到打补丁后的结果:

$ ls 
prj1name test1 

类似的,如果要回滚补丁操作:

$ patch -R -p1 < ../prj1.patch 
patching file prj0name 
patching file prj1name 
patching file test0 
patching file test1 
$ ls 
prj0name test0 

在 Windows 下

您可以安装 mingw,或者安装 Git,或者 RailsInstaller 等之类的,他们都包括了 diff 和 patch。如果您并不想安装这些庞然大物,可以尝试我打包的 diff 和 patch

文件清单

README.md
您正在阅读的这个说明文档。
msys-1.0.dll
MSYS POSIX Emulation DLL 1.0.12
diff.exe
diff - GNU diffutils version 2.7
patch.exe
patch 2.5
patch.exe.manifest
解决 patch.exe 的 UAC 问题所需的清单文件

如何使用

我个人推荐您将除了说明文件之外的四个文件都放置到 Windows\System32 目录下, 当然放到您 PATH 变量中所包含的目录也可以。

在这之后您便可以在命令行提示符中享受 diff 与 patch 给您带来的便利。