Linux diff 命令:比较文件与目录、读取差异和生成补丁

diff 逐行比较两个文本文件,显示从第一个文件变为第二个文件所需的改动。-u 用统一格式展示差异和上下文,-r 还可比较目录中的对应子目录,适合检查配置和源代码。

本文以 GNU Diffutils 中的 GNU diff 为准,示例在 Bash 等 shell 中执行。先用 diff --version、diff --help 和 man diff 核对实现;其他版本的长选项和颜色支持可能不同。比较本身读取输入,示例中的文件写入仅用于准备练习或保存补丁。

diff 命令是什么?

diff 比较行的内容,不判断代码或配置的实际语义。GNU diff 的退出状态 0 表示按当前选项没有差异,1 表示有差异,2 表示遇到问题,例如输入文件无法读取。没有标准输出时,也应结合状态和错误信息判断,不能只看屏幕是否空白。

基本语法

diff [OPTION]... FILE1 FILE2
diff [OPTION]... DIRECTORY1 DIRECTORY2

OPTION、FILE1 等是占位符,应替换为选项和已存在的路径。含空格的文件名应加引号,例如 diff -u -- "old file.conf" "new file.conf";双横线分隔选项和文件名。单独的 - 可表示标准输入。两个参数都是目录时,会比较对应名称,并报告只存在于一侧的项目。

diff 的基本用法

比较两个文件

默认的传统格式用 a、c、d 表示添加、修改和删除。例如 1c1 表示把第一个文件的第 1 行改为第二个文件的第 1 行;< 开头是旧内容,> 开头是新内容。下面需要事先准备两个配置文件副本,不会修改它们。

diff old.conf new.conf

使用统一格式

-u 把变化与上下文一起显示,默认包含变化前后各三行上下文;文件较短或接近边界时会少一些。可用 -U 5 改为五行。交换两个输入的顺序,也会反转变化方向。

diff -u old.conf new.conf

递归比较目录

-r 进入对应的子目录,-u 为文本文件保留统一格式。请将参数替换为已存在的目录树。只在一侧存在的文件通常以提示信息报告;若要把缺失文件视为空文件,可评估 GNU 的 -N,不要把普通目录摘要误当成完整补丁。

diff -ru project-old project-new

目录比较不等于检查所有者、权限等全部元数据,也不能代替备份。若要比较符号链接本身而不跟随链接,需核对 GNU 的 --no-dereference 等相应选项及实际需求。

如何读取统一格式与退出状态?

以下完整示例在新目录 diff-demo 中建立两个文件。若目录已存在,会退出而不覆盖其中内容;重复练习时请另选目录名。括号把工作目录变化限制在子 shell 内,--label 则为输出提供稳定的文件标签,省略时间戳。

(
  mkdir diff-demo || exit 1
  cd diff-demo || exit 1
  printf 'old\n' > before.txt || exit 1
  printf 'new\n' > after.txt || exit 1
  diff_status=0
  diff -u --label before.txt --label after.txt before.txt after.txt || diff_status=$?
  printf '状态: %s\n' "$diff_status"
  case "$diff_status" in 0|1) ;; *) exit "$diff_status" ;; esac
)

下面是比较部分的完整输出,其后还会显示 状态: 1:

--- before.txt
+++ after.txt
@@ -1 +1 @@
-old
+new

--- 和 +++ 标识第一、第二个输入。@@ -1 +1 @@ 标识一个差异块(hunk),两侧都从第 1 行开始、各涉及一行;较长范围会使用“起始行,行数”。差异块内 - 表示从第一个文件删除,+ 表示在第二个文件添加,开头空格表示未变化的上下文行。退出状态 1 表示找到了差异。

常用选项

选项 用途与限制
-u 统一格式,默认三行上下文;-U NUM 指定行数。
-r、--recursive 递归比较对应子目录。
-q、--brief 只报告是否不同,仍需区分退出状态 0、1、2。
-s 也明确报告相同的文件。
-w 忽略行内空白差异,包括有无空白的区别;不会消除行边界。
-b 忽略空白数量变化及行尾空白;行内有一个空格与完全没有空格仍不同。
-i 忽略内容的大小写差异,不等同于忽略文件名大小写。
--color=auto 在支持的 GNU 版本中对终端输出着色;--color=never 禁用颜色。

实用示例

生成补丁文件

下面是独立的完整练习,新建 diff-patch-demo,建立两个小配置文件并保存差异。set -C 防止重定向截断已存在的普通输出文件。状态 1 作为有效差异处理,状态 2 则停止;出错产生的文件不能作为有效补丁使用。--color=never 避免把终端颜色控制码写入补丁,两个标签都指向目标 app.conf。

(
  mkdir diff-patch-demo || exit 1
  cd diff-patch-demo || exit 1
  set -C
  printf 'port=8080\n' > original.conf || exit 1
  printf 'port=9090\n' > modified.conf || exit 1
  diff_status=0
  diff -u --color=never --label app.conf --label app.conf \
    original.conf modified.conf > config.patch || diff_status=$?
  case "$diff_status" in
    0) printf '没有差异,补丁为空。\n' ;;
    1) printf '已生成补丁: diff-patch-demo/config.patch\n' ;;
    *) printf 'diff 出错: %s\n' "$diff_status" >&2; exit "$diff_status" ;;
  esac
)

运行后,config.patch 应描述把 port=8080 改为 port=9090。diff 只生成补丁文字,应用补丁由 patch 完成。若要练习应用,先进入 cd diff-patch-demo,用 (set -C; cat original.conf > app.conf) 建立目标副本;如果 app.conf 已存在,该复制步骤会失败,不应覆盖它。

确认副本内容正确后,先运行 patch --dry-run -p0 < config.patch 检查可应用性,不修改目标。确认无误再运行 patch -p0 < config.patch;结果应与 modified.conf 一致。这里 -p0 保留 app.conf 名称;含目录前缀的其他补丁需另行判断 -p。真实文件应先备份或保留可恢复版本,并检查补丁头、内容和目标目录。

汇总目录变化

-qr 报告内容不同的文件,以及只存在于一侧的项目,不打印全部变化行。可准备两棵目录树:其中同名文件内容不同,另有一个文件只在第一棵树中;结果应同时包含这两类提示。它是供人阅读的报告,不是可以直接用于批量删除的安全文件名列表。

diff -qr release-a release-b

忽略空白数量变化

下面要求两个输入文件已经存在。若字母 a、b 之间分别有两个空格和一个空格,-b 不报告差异;若比较 ab 和 a b,-b 仍会报告差异,-w 则会忽略这一差别。缩进、字符串和数据中的空白可能有意义,应先检查普通比较结果。

diff -u -b before.txt after.txt

diff 与相关命令如何选择?

命令 主要作用 适用场景
diff 逐行比较文本 源代码、配置及目录树内容变化。
cmp 逐字节比较,通常报告首个不同位置 检查完全相同或定位第一个不同字节。
git diff 结合 Git 的变化比较 工作区及版本间的改动。
comm 比较按同一规则排序的两份行列表 区分共同和单侧内容,注意重复行。

使用时应注意什么?

状态 1 表示有差异

脚本应立即保存状态并区分 0、1、2。启用 set -e 时,直接执行一个发现差异的 diff 可能使脚本提前退出。示例采用 diff_status=0; diff ... || diff_status=$?,然后分别处理结果。若需要识别读取错误,不应简单用 diff ... || true 隐藏所有非零状态。

二进制文件应选择合适工具

对识别为二进制的文件,diff 通常只报告是否不同。需要精确字节比较时可用 cmp;diff -a 虽强制按文本处理,却不会让任意二进制变化都成为可靠的文本补丁。还应核对编码和换行格式;GNU 的 --strip-trailing-cr 可忽略行尾 CR,但只有在这种归一化符合目的时才使用。

忽略选项可能隐藏真实变化

空格和制表符可能改变 Python 缩进、字符串或数据的含义。忽略它们只是比较过滤,并不会修正文件。即使使用 -w,行边界仍然重要;文件末尾是否有换行也可能产生差异,出现相关提示时应结合内容一起检查。

常见问题

diff 没有输出是什么意思?

若状态为 0,表示按所选选项没有差异;-w 等过滤仍可能隐藏字节差异。若状态为 2,即使标准输出为空也应检查标准错误,不能认为文件相同。

哪种输出格式容易阅读?

diff -u 的统一格式把变化和上下文放在一起,文件头区分输入,差异块内的减号、加号区分删除和添加。

可以比较整个目录吗?

可以,-r 递归比较对应子目录,-q 减少输出细节。但它不检查全部元数据,单侧文件与符号链接的处理也需单独核对。

退出状态 1 是错误吗?

对 GNU diff,1 表示发现差异,0 表示按当前选项无差异,2 表示遇到问题。脚本应分别处理,不能把比较中的差异一律算作执行故障。

相关资料与官方文档