Linux diff 指令

Linux diff 指令

diff 是一个在 Linux 和 Unix 系统中广泛使用的命令行工具，用于比较两个文件或目录的内容差异。它是开发人员、系统管理员和任何需要跟踪文件版本变化的用户必备的工具。diff 的输出清晰地展示了文件之间的差异，常用于版本控制、代码审查、配置管理等场景。

一、diff 命令简介

diff（difference 的缩写）用于比较两个文本文件的内容，输出它们之间的差异。它的基本工作原理是逐行比较文件，识别出哪些行被添加、删除或修改。diff 不仅限于比较单个文件，还可以递归地比较目录中的文件，适合用于批量分析。

基本语法

diff [选项] 文件1 文件2
diff [选项] 目录1 目录2

• 文件1 文件2：要比较的两个文件。
• 目录1 目录2：要比较的两个目录，diff 会递归比较目录中所有文件的差异。
• 选项：控制 diff 行为的参数，例如输出格式、忽略某些差异等。

常用场景

1. 代码审查：比较代码文件的新旧版本，找出改动。
2. 配置文件管理：检查配置文件的变化。
3. 版本控制：在 Git、SVN 等版本控制系统之前，diff 是手动比较版本差异的主要工具。
4. 自动化脚本：在脚本中检测文件变化，触发相应操作。

二、diff 的核心选项

diff 提供了丰富的选项，允许用户自定义比较行为和输出格式。以下是一些常用的选项：

三、diff 的输出格式

diff 的输出格式有多种，常见的有普通格式（normal diff）、上下文格式（context diff）和统一格式（unified diff）。下面详细介绍每种格式的特点。

1. 普通格式（Normal Diff）

普通格式是 diff 的默认输出，简洁但信息量较少，适合快速查看差异。

示例：
假设有两个文件 file1.txt 和 file2.txt：

# file1.txt
Hello, world!
This is a test.
Line three.
# file2.txt
Hello, world!
This is a TEST.
Line four.

运行命令：

diff file1.txt file2.txt

输出：

2c2
< This is a test.
---
> This is a TEST.
3c3
< Line three.
---
> Line four.

解释：

• 2c2：表示第 2 行发生了变化（c 表示 change）。
• < This is a test.：file1.txt 中的第 2 行。
• > This is a TEST.：file2.txt 中的第 2 行。
• 3c3：第 3 行也发生了变化。
• < 和 > 分别表示第一个和第二个文件的内容。

普通格式适合简单的比较，但当文件较大或需要上下文时，阅读起来不够直观。

2. 上下文格式（Context Diff）

上下文格式通过 -c 选项启用，显示差异行的上下文（通常是前后三行），便于理解改动的位置。

示例：

diff -c file1.txt file2.txt

输出：

*** file1.txt   2025-04-28 10:00:00
--- file2.txt   2025-04-28 10:00:00
***************
*** 1,3 ****
  Hello, world!
! This is a test.
! Line three.
--- 1,3 ----
  Hello, world!
! This is a TEST.
! Line four.

解释：

• *** file1.txt 和 --- file2.txt：显示文件名称和时间戳。
• *** 1,3 ****：表示 file1.txt 的第 1 到 3 行。
• !：表示改动的行。
• 上下文格式清晰地展示了差异行的前后内容，适合代码审查。

3. 统一格式（Unified Diff）

统一格式通过 -u 选项启用，是最常用的格式，广泛用于 Git 和补丁文件（patch）。它比上下文格式更紧凑，显示更少的冗余信息。

示例：

diff -u file1.txt file2.txt

输出：

--- file1.txt   2025-04-28 10:00:00
+++ file2.txt   2025-04-28 10:00:00
@@ -1,3 +1,3 @@
 Hello, world!
-This is a test.
+This is a TEST.
-Line three.
+Line four.

解释：

• --- 和 +++：分别表示旧文件和新文件。
• @@ -1,3 +1,3 @@：表示比较的行范围（-1,3 是 file1.txt 的第 1 到 3 行，+1,3 是 file2.txt 的第 1 到 3 行）。
• -：表示删除的行。
• +：表示添加的行。
• 没有标记的行是上下文。

统一格式因其紧凑性和清晰性，成为版本控制系统（如 Git）的默认格式。

四、具体示例

以下通过具体场景展示 diff 的使用方法。

示例 1：比较两个配置文件

假设有两个 Nginx 配置文件，比较它们的差异。

nginx1.conf：

server {
    listen 80;
    server_name example.com;
    root /var/www/html;
}

nginx2.conf：

server {
    listen 80;
    server_name example.com;
    root /var/www/html;
    index index.html;
}

运行命令：

diff -u nginx1.conf nginx2.conf

输出：

--- nginx1.conf   2025-04-28 10:00:00
+++ nginx2.conf   2025-04-28 10:00:00
@@ -1,4 +1,5 @@
 server {
     listen 80;
     server_name example.com;
     root /var/www/html;
+    index index.html;
 }

分析：

• nginx2.conf 增加了一行 index index.html;。
• 统一格式清楚地展示了新增行。

示例 2：忽略空白字符

假设两个文件内容相同，但空白字符不同。

file1.txt：

Hello   world
This is a test

file2.txt：

Hello world
This is a test

运行命令：

diff -w file1.txt file2.txt

输出：
无输出，因为 -w 忽略了空格差异。

示例 3：并排比较

使用 -y 选项并排显示差异。

diff -y file1.txt file2.txt

输出：

Hello, world!                           Hello, world!
This is a test.                       | This is a TEST.
Line three.                           | Line four.

分析：

• 相同行并排显示。
• | 表示差异行。
• 并排格式直观，但当行较长时可能难以阅读。

示例 4：递归比较目录

假设有两个目录 dir1 和 dir2：

dir1/
├── file1.txt
└── subdir/
    └── file2.txt
dir2/
├── file1.txt
└── subdir/
    └── file3.txt

运行命令：

diff -r dir1 dir2

输出：

diff dir1/file1.txt dir2/file1.txt
0a1
> New line in file2
Only in dir1/subdir: file2.txt
Only in dir2/subdir: file3.txt

分析：

• -r 递归比较所有文件。
• 显示 file1.txt 的差异。
• 报告仅存在于某个目录的文件。

五、高级用法

1. 与 patch 结合使用

diff 的输出可以与 patch 命令结合，用于应用补丁。

示例：
生成补丁文件：

diff -u file1.txt file2.txt > patchfile.patch

应用补丁：

patch file1.txt < patchfile.patch

这会将 file1.txt 更新为 file2.txt 的内容。

2. 在脚本中检测文件变化

使用 -q 选项在脚本中检查文件是否不同。

示例脚本：

#!/bin/bash
if diff -q file1.txt file2.txt >/dev/null; then
    echo "Files are identical"
else
    echo "Files differ"
fi

3. 结合 Git

Git 使用 diff 的统一格式显示提交差异。可以用 diff 直接比较 Git 工作目录中的文件。

示例：

git diff file1.txt

等效于：

diff -u file1.txt .git/HEAD/file1.txt

4. 忽略特定模式

使用 --exclude 忽略特定文件或目录。

示例：
忽略 .log 文件：

diff -r --exclude="*.log" dir1 dir2

5. 自定义输出颜色

结合 colordiff 工具，使 diff 输出带颜色。

安装 colordiff：

sudo apt install colordiff

使用：

diff -u file1.txt file2.txt | colordiff

效果：

• 删除行显示为红色。
• 添加行显示为绿色。

六、常见问题与解决方案

1. 输出太长怎么办？
   使用 less 或 more 分页查看：

   diff -u file1.txt file2.txt | less
   

2. 如何只显示不同行的摘要？
   使用 -q 选项：

   diff -q file1.txt file2.txt
   

3. 如何处理二进制文件？
   diff 默认不处理二进制文件，可用 -a 选项强制按文本比较：

   diff -a binary1 binary2
   

4. 如何比较大文件？
   对于大文件，diff 可能较慢，可用 cmp 快速比较：

   cmp file1 file2
   

七、总结

diff 是一个功能强大且灵活的工具，适用于各种文件和目录比较场景。通过丰富的选项和输出格式，用户可以轻松定制比较行为。无论是简单的文本比较，还是复杂的目录递归分析，diff 都能胜任。结合 patch、脚本和版本控制系统，diff 的应用场景进一步扩展。

更多技术分享，关注公众号：halugin