Linux diff 与 patch 命令实战指南

3. 统一格式输出（推荐）

$ diff -u config-v1.txt config-v2.txt
--- config-v1.txt	2024-01-01 10:00:00
+++ config-v2.txt	2024-01-01 11:00:00
@@ -1,6 +1,7 @@
 # 服务器配置
-port=8080
-host=localhost
-debug=false
-max_connections=100
+port=9090
+host=0.0.0.0
+debug=true
+max_connections=200
+timeout=30

diff 常用选项

patch 命令详解

基本语法

patch [选项] [原始文件] [补丁文件]

patch 工作流程

patch 应用补丁时通常遵循以下逻辑：首先检查补丁文件是否匹配原始文件，计算文件指纹；如果匹配则直接应用，若不匹配则尝试偏移匹配；若仍失败，会保存 .rej 拒绝文件并创建备份 .orig。

实战示例

场景 1：应用简单补丁

# 生成补丁
$ diff -u config-v1.txt config-v2.txt > config.patch

# 应用补丁
$ patch config-v1.txt < config.patch
patching file config-v1.txt

# 验证结果
$ cat config-v1.txt
# 服务器配置
port=9090
host=0.0.0.0
debug=true
max_connections=200
timeout=30

场景 2：带备份的应用

# 应用补丁并创建备份
$ patch -b config-v1.txt < config.patch

# 查看备份文件
$ ls config-v1.txt*
config-v1.txt  config-v1.txt.orig

场景 3：回退补丁

# 使用 -R 反向应用补丁
$ patch -R config-v1.txt < config.patch

patch 常用选项

实战场景应用

场景 1：软件源码补丁管理

开源软件打补丁的标准流程通常是下载源码后应用社区补丁，编译测试通过后再提交反馈。

# 下载 nginx 源码
$ wget http://nginx.org/download/nginx-1.20.0.tar.gz
$ tar xzf nginx-1.20.0.tar.gz
$ cd nginx-1.20.0

# 应用官方补丁
$ wget http://nginx.org/patches/patch.1.diff
$ patch -p1 < patch.1.diff

场景 2：配置文件版本管理

假设我们有多环境配置结构：

config/
├── dev/
│   └── app.conf
├── prod/
│   └── app.conf
└── patches/
    └── database.patch

database.patch 内容示例：

--- config/dev/app.conf
+++ config/prod/app.conf
@@ -1,5 +1,5 @@
database {
- host=localhost
- port=3306
+ host=prod-db.example.com
+ port=3307
user=app_user
- password=dev_pass
+ password=${DB_PASSWORD}
}

场景 3：代码审查与协作

在团队协作中，开发者 A 发现 Bug 后发送补丁，开发者 B 获取更新并应用修复，最后提交代码仓库。这种方式避免了直接合并冲突，便于审查。

最佳实践与技巧

1. 创建高质量补丁

# 使用统一格式，包含更多上下文
$ diff -u5 old.py new.py > quality.patch

# 递归比较整个目录
$ diff -urN old_project/ new_project/ > project.patch

2. 路径处理技巧

补丁文件中常包含 a/ 和 b/ 前缀，应用时需剥离：

# 假设补丁文件内容
# --- a/src/main.c
# +++ b/src/main.c

# 应用时剥离 a/ 前缀
$ patch -p1 < patch.diff

路径剥离示例：

• -p0: 保留完整路径 a/src/main.c
• -p1: 去掉一级目录 src/main.c
• -p2: 去掉两级目录 main.c

3. 补丁管理策略

4. 常见问题解决

问题 1：补丁应用失败

$ patch < patch.diff
1 out of 1 hunk FAILED -- saving rejects to file.rej

解决方案：检查 .rej 文件手动合并。

$ cat file.rej
$ vim file

问题 2：文件名不匹配

# 使用 -p 选项调整路径
$ patch -p2 < patch.diff

5. 实用脚本示例

批量应用补丁脚本：

#!/bin/bash
# apply-patches.sh
PATCH_DIR="patches"
BACKUP_DIR="backups"
mkdir -p $BACKUP_DIR

for patch in $PATCH_DIR/*.patch; do
    echo "Applying $patch..."
    # 创建时间戳备份
    cp -r src $BACKUP_DIR/src-$(date +%Y%m%d-%H%M%S)
    
    # 尝试应用补丁
    if patch -p1 -d src < $patch; then
        echo "✓ $patch applied successfully"
    else
        echo "✗ $patch failed, check $patch.rej"
        # 回滚更改
        cp -r $BACKUP_DIR/src-* src
    fi
done

总结

diff 和 patch 是 Linux 系统中强大的文本处理工具，它们：

• diff：精确比较文件差异，生成可读性强的补丁
• patch：智能应用补丁，支持备份和回滚
• 配合使用：实现高效的代码分发和版本管理

掌握这些工具，你将能够轻松管理配置文件的多环境差异，高效协作开发分享代码修改，以及自动化软件包和补丁管理。记住：diff 找差异，patch 解差异，这对黄金搭档是 Linux 文本处理中不可或缺的工具！