自从我开始使用 Git 以及接触 Linux 之后,我发现我越来越离不开 Linux 上那些方便好用的工具。比如 diff
& patch
,相对于 Windows 自带的 fc
要好用太多太多。
如果修改了开源代码,为了方便分享(如提交漏洞)或自己留存使用,一般都要制作一个补丁。在从源码安装软件时,也难免要应用些别人做好的补丁,本文介绍如何制作和应用补丁。
diff 简介
diff 可以比较两个东西,并可同时记录下二者的区别。制作补丁时的一般用法和常见选项为:
1 | diff 【选项】 源文件(夹) 目的文件(夹) |
- -r
- 递归。设置后diff会将两个不同版本源代码目录中的所有对应文件全部都进行一次比较,包括子目录文件。
- -N
- 选项确保补丁文件将正确地处理已经创建或删除文件的情况。
- -u
- 输出每个修改前后的3行,也可以用-u5等指定输出更多上下文。
- -E, -b, -w, -B, –strip-trailing-cr
- 忽略各种空白,可参见文档,按需选用。
patch 简介
patch的作用则是将 diff 记录的结果(即补丁)应用到相应文件(夹)上。最常见的用法为:
1 | patch -pNUM < patchfile |
- -p Num
- 忽略几层文件夹,随后详解。
- -E
- 选项说明如果发现了空文件,那么就删除它
- -R
- 取消打过的补丁。
为了解释 -p 参数,需要看看如下 patch 文件片段:
1 2 | --- 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。
简单应用
利用以上命令,处理单个文件补丁的方法:
1 2 3 4 5 6 7 8 | # 产生补丁 diff -uN from-file to-file >to-file.patch # 打补丁 patch -p0 < to-file.patch # 取消补丁 patch -RE -p0 < to-file.patch |
对整个文件夹打补丁的情况:
1 2 3 4 5 6 7 8 9 | # 产生补丁 diff -uNr from-docu to-docu >to-docu.patch # 打补丁 cd to-docu patch -p1 < to-docu.patch # 取消补丁 patch -R -p1 |
另外,使用版本控制工具时,可以直接用svn diff或git diff生成补丁文件。
值得一提的是,由于应用补丁时的目标代码和生成补丁时的代码未必相同,打补丁操作可能失败。补丁失败的文件会以.rej结尾,下面命令可以找出所有rej文件:
1 | find . -name '*.rej' |
patch 文件构成
补丁文件里到底存储了哪些信息呢?看看这个例子:
1 2 3 4 5 6 7 8 | --- 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:
1 2 3 | 111111 111111 111111 |
和文件test1:
1 2 3 4 | 222222 111111 222222 111111 |
使用diff创建补丁test1.patch
1 | diff -uN test0 test1 > test1.patch |
因为是单个文件,故不需要 -r 选项。此命令得到如下补丁:
1 2 3 4 5 6 7 8 | --- 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 |
要应用补丁,只需:
1 2 | $ patch -p0 < test1.patch patching file test0 |
此时test0就和test1一样了。
如果要取消补丁做出的更改,恢复旧版本:
1 2 | $ patch -RE -p0 < test1.patch patching file test0 |
文件夹实例分析
设有如下环境:
1 2 3 4 5 6 | --prj0/ test0 prj0name --prj1/ test1 prj1name |
prj0/prj0name内容为如下三行:
1 2 3 | -------- prj0/prj0name -------- |
prj1/prj1name内容为如下三行:
1 2 3 | -------- prj1/prj1name -------- |
用 diff -uNr 创建补丁,
1 | diff -uNr prj0 prj1 > prj1.patch |
得到的patch文件为:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 | 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 |
如果要应用此补丁,则:
1 2 3 4 5 6 7 8 | $ ls prj0 prj1 prj1.patch $ cd prj0 $ patch -p1 < ../prj1.patch patching file prj0name patching file prj1name patching file test0 patching file test1 |
此时可用ls看到打补丁后的结果:
1 2 | $ ls prj1name test1 |
类似的,如果要回滚补丁操作:
1 2 3 4 5 6 7 | $ 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。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 | Tour-DiffAndPatch ================== 这是 [《diff 和 patch 的入门(及 Windows 下的用法)》](http://orzfly.com/html/diff-and-patch-and-windows.html) 一文中提到的适合 Windows 使用的 diff 和 patch。 文件清单 -------- <dl> <dt>README.md</dt> <dd>您正在阅读的这个说明文档。</dd> <dt>msys-1.0.dll</dt> <dd>MSYS POSIX Emulation DLL 1.0.12</dd> <dt>diff.exe</dt> <dd>diff - GNU diffutils version 2.7</dd> <dt>patch.exe</dt> <dd>patch 2.5</dd> <dt>patch.exe.manifest</dt> <dd>解决 patch.exe 的 UAC 问题所需的清单文件</dd> </dl> 如何使用 -------- 我个人推荐您将除了说明文件之外的四个文件都放置到 Windows\System32 目录下, 当然放到您 PATH 变量中所包含的目录也可以。 在这之后您便可以在命令行提示符中享受 diff 与 patch 给您带来的便利。 |
Pingback: orzFly / Discuz X2.0 通过邮件发送注册链接