diffutils文件对比：鸿蒙PC上的diff工具集

ohos-diffutils是为 OpenHarmony 平台编译的 GNU diffutils 工具集。本文档详细介绍如何在鸿蒙PC上安装和使用官方适配完成的 diffutils 工具，包括 HNP 包的打包、安装和使用方法。

📋 目录

• 一、项目概述
• 二、为什么需要 HNP 包
• 三、HNP 包打包方法
• 四、安装与使用
• 五、使用示例
• 六、常见问题
• 七、总结与最佳实践
• 八、参考资料

一、项目概述

1.1 diffutils 工具简介

diffutils是 GNU 项目提供的文件对比工具集，包含diff、cmp、diff3和sdiff等工具。这些工具用于比较文件之间的差异，是版本控制、代码审查和文件管理的重要工具。

核心工具：

• 📊diff：逐行比较两个文件，显示差异
• 🔍cmp：逐字节比较两个文件，显示第一个差异位置
• 📝diff3：比较三个文件，显示合并冲突
• 📋sdiff：并排显示两个文件的差异

核心特性：

• 🔎精确比较：逐行或逐字节比较文件内容
• 📝多种格式：支持统一格式、上下文格式、并排格式等
• ⚡高效算法：使用优化的算法快速比较大文件
• 🎯灵活输出：支持多种输出格式和选项
• 🔧目录比较：支持递归比较目录结构

主要应用场景：

• 代码版本对比和差异分析
• 配置文件变更检查
• 文件同步和备份验证
• 代码审查和合并冲突解决
• 自动化测试和回归测试
  

1.2 项目信息

1.3 diffutils 工具详解

diff 命令

diff是最常用的文件比较工具，可以逐行比较两个文件并显示差异。

主要功能：

• 比较两个文件或目录
• 显示添加、删除、修改的行
• 支持多种输出格式（统一格式、上下文格式等）
• 生成补丁文件

cmp 命令

cmp逐字节比较两个文件，显示第一个差异的位置。

主要功能：

• 快速检测文件是否相同
• 显示第一个差异的字节位置
• 适合二进制文件比较

diff3 命令

diff3比较三个文件，用于合并场景。

主要功能：

• 比较三个文件（原始文件、文件A、文件B）
• 显示合并冲突
• 生成合并结果

sdiff 命令

sdiff并排显示两个文件的差异。

主要功能：

• 并排显示两个文件
• 标记差异行
• 交互式合并选项

1.4 为什么需要 ohos-diffutils？

在鸿蒙PC上进行开发时，我们经常需要：

1. ✅代码对比：比较不同版本的代码文件
2. ✅配置管理：检查配置文件的变更
3. ✅版本控制：生成和应用补丁文件
4. ✅代码审查：查看代码修改内容
5. ✅自动化测试：验证文件是否按预期修改

二、为什么需要 HNP 包

2.1 系统安全限制

重要说明：在鸿蒙PC上，由于系统安全规格限制等原因，暂不支持通过"解压 + 配 PATH"的方式直接使用 tar.gz 包。

这意味着：

• ❌ 不能直接解压 tar.gz 包到任意目录
• ❌ 不能通过设置 PATH 环境变量来使用
• ✅ 必须打包成 HNP（HarmonyOS Native Package）格式才能正常使用

2.2 HNP 包的优势

HNP 包是鸿蒙PC的官方包管理格式，具有以下优势：

• ✅系统集成：与鸿蒙PC的包管理系统集成
• ✅安全可靠：通过官方工具安装，符合系统安全规范
• ✅易于管理：支持安装、卸载、更新等操作
• ✅路径规范：统一安装在/data/service/hnp/目录下

2.3 其他平台的使用方式

在鸿蒙开发板上：

可以使用传统的"解压 + 配 PATH"方式：

# 使用 hdc 推送文件到设备hdcfilesend diffutils-*-ohos-arm64.tar.gz /data# 进入设备 shellhdc shell# 解压并配置cd/datatar-zxf diffutils-*-ohos-arm64.tar.gzexportPATH=$PATH:/data/diffutils-*-ohos-arm64/bin

三、HNP 包打包方法

3.1 准备工作

在开始打包之前，需要准备以下内容：

1. 预构建的 tar.gz 包：从 release 页面 下载
2. hnpcli 工具：鸿蒙PC的包管理工具
3. 打包脚本：用于自动化打包过程

3.2 下载预构建包

# 下载 diffutils 预构建包wgethttps://github.com/Harmonybrew/ohos-diffutils/releases/download/latest/diffutils-*-ohos-arm64.tar.gz

3.3 创建打包脚本

创建一个pack_hnp.sh脚本来自动化打包过程：

#!/bin/bashset-e# 配置变量DIFFUTILS_VERSION="3.10"# 根据实际版本调整TAR_FILE="diffutils-${DIFFUTILS_VERSION}-ohos-arm64.tar.gz"EXTRACT_DIR="diffutils-${DIFFUTILS_VERSION}-ohos-arm64"HNP_PUBLIC_PATH="/data/service/hnp"DIFFUTILS_INSTALL_PATH="${HNP_PUBLIC_PATH}/diffutils.org/diffutils_${DIFFUTILS_VERSION}"OUTPUT_DIR="output"WORKDIR=$(pwd)# 创建输出目录mkdir-p${OUTPUT_DIR}# 解压 tar.gz 包if[!-d"${EXTRACT_DIR}"];thenecho"解压${TAR_FILE}..."tar-zxf${TAR_FILE}fi# 创建安装目录echo"创建安装目录..."mkdir-p${DIFFUTILS_INSTALL_PATH}/bin# 复制文件echo"复制文件..."cp-r${EXTRACT_DIR}/bin/*${DIFFUTILS_INSTALL_PATH}/bin/if[-f"${EXTRACT_DIR}/COPYING"];thencp${EXTRACT_DIR}/COPYING${DIFFUTILS_INSTALL_PATH}/fiif[-f"${EXTRACT_DIR}/AUTHORS"];thencp${EXTRACT_DIR}/AUTHORS${DIFFUTILS_INSTALL_PATH}/fi# 创建 hnp.jsonecho"创建 hnp.json..."cat>${DIFFUTILS_INSTALL_PATH}/hnp.json<<'EOF' { "type": "hnp-config", "name": "diffutils", "version": "3.10", "install": { "links": [ { "source": "bin/diff", "target": "diff" }, { "source": "bin/cmp", "target": "cmp" }, { "source": "bin/diff3", "target": "diff3" }, { "source": "bin/sdiff", "target": "sdiff" } ] } } EOF# 设置执行权限chmod+x${DIFFUTILS_INSTALL_PATH}/bin/*# 使用 hnpcli 打包（如果可用）ifcommand-v hnpcli&>/dev/null;thenecho"使用 hnpcli 打包..."hnpcli pack -i${DIFFUTILS_INSTALL_PATH}-o${OUTPUT_DIR}/echo"HNP 包已生成:${OUTPUT_DIR}/diffutils.hnp"elseecho"警告: 未找到 hnpcli 工具，跳过 HNP 包生成"echo"请手动使用 hnpcli 打包:"echo" hnpcli pack -i${DIFFUTILS_INSTALL_PATH}-o${OUTPUT_DIR}/"fi# 生成 tar.gz 包（备用）echo"生成 tar.gz 包..."cd${HNP_PUBLIC_PATH}/diffutils.orgtar-zcf${WORKDIR}/${OUTPUT_DIR}/ohos_diffutils_${DIFFUTILS_VERSION}.tar.gz diffutils_${DIFFUTILS_VERSION}/cd->/dev/nullecho"打包完成！"echo"输出文件："echo" -${OUTPUT_DIR}/diffutils.hnp (如果 hnpcli 可用)"echo" -${OUTPUT_DIR}/ohos_diffutils_${DIFFUTILS_VERSION}.tar.gz"

3.4 执行打包

# 赋予脚本执行权限chmod+x pack_hnp.sh# 执行打包./pack_hnp.sh

3.5 验证打包结果

打包完成后，验证生成的文件：

# 检查 HNP 包ls-lh output/diffutils.hnp# 检查 tar.gz 包ls-lh output/ohos_diffutils_*.tar.gz# 验证安装目录结构tree${DIFFUTILS_INSTALL_PATH}/

预期的安装目录结构：

/data/service/hnp/diffutils.org/diffutils_3.10/ ├── bin/ │ ├── diff # diff 可执行文件 │ ├── cmp # cmp 可执行文件 │ ├── diff3 # diff3 可执行文件 │ └── sdiff # sdiff 可执行文件 ├── COPYING # 许可证文件 ├── AUTHORS # 作者信息 └── hnp.json # HNP 配置文件

四、安装与使用

4.1 安装 HNP 包

手动安装（使用 tar.gz）

# 在鸿蒙PC上执行# 1. 解压 tar.gz 包tar-xzf ohos_diffutils_*.tar.gz# 2. 复制到安装目录sudocp-r diffutils_*/* /data/service/hnp/diffutils.org/diffutils_*/# 3. 设置执行权限sudochmod+x /data/service/hnp/diffutils.org/diffutils_*/bin/*# 4. 创建符号链接（根据 hnp.json 配置）# hnp 系统会自动处理 links 配置

4.2 验证安装

# 检查 diff 是否可用diff--version# 检查 cmp 是否可用cmp--version# 检查 diff3 是否可用diff3--version# 检查 sdiff 是否可用sdiff--version

4.3 使用 diffutils

安装完成后，就可以使用 diff、cmp、diff3 和 sdiff 命令了。

五、使用示例

5.1 diff 命令示例

基本比较

# 比较两个文件difffile1.txt file2.txt# 比较并显示上下文（3行）diff-c file1.txt file2.txt# 比较并显示统一格式diff-u file1.txt file2.txt# 忽略空白差异diff-b file1.txt file2.txt# 忽略大小写diff-i file1.txt file2.txt

目录比较

# 递归比较两个目录diff-r dir1/ dir2/# 递归比较并显示统一格式diff-ru dir1/ dir2/# 只显示文件名差异diff-rq dir1/ dir2/

生成补丁文件

# 生成统一格式补丁diff-u original.txt modified.txt>patch.txt# 应用补丁patch original.txt<patch.txt# 生成目录补丁diff-ru original_dir/ modified_dir/>patch.diff

高级选项

# 显示行号diff-u -n file1.txt file2.txt# 忽略空行diff-B file1.txt file2.txt# 忽略所有空白diff-w file1.txt file2.txt# 显示并排格式diff-y file1.txt file2.txt

5.2 cmp 命令示例

基本比较

# 比较两个文件cmpfile1.txt file2.txt# 显示第一个差异的字节位置cmp-b file1.txt file2.txt# 显示所有差异cmp-l file1.txt file2.txt# 只显示是否相同（退出码）cmp-s file1.txt file2.txtecho$?# 0=相同, 1=不同

二进制文件比较

# 比较二进制文件cmpbinary1.bin binary2.bin# 显示差异的十六进制cmp-l binary1.bin binary2.bin|head-20

5.3 diff3 命令示例

三路比较

# 比较三个文件（原始、文件A、文件B）diff3original.txt fileA.txt fileB.txt# 显示合并格式diff3-m original.txt fileA.txt fileB.txt>merged.txt# 显示编辑脚本diff3-e original.txt fileA.txt fileB.txt

解决合并冲突

# 生成合并结果diff3-m original.txt fileA.txt fileB.txt>merged.txt# 查看冲突标记grep-n"<<<<<<< \|======= \|>>>>>>> "merged.txt

5.4 sdiff 命令示例

并排显示

# 并排显示两个文件sdifffile1.txt file2.txt# 显示宽格式（130列）sdiff-w130file1.txt file2.txt# 只显示差异行sdiff-s file1.txt file2.txt

交互式合并

# 交互式合并选项sdiff-o merged.txt file1.txt file2.txt# 合并选项：# ed - 编辑差异# eb - 编辑两个文件# el - 使用左侧文件# er - 使用右侧文件# e - 编辑新版本

5.5 实际应用场景

代码版本对比

# 比较两个版本的代码文件diff-u old_version.c new_version.c# 生成补丁文件diff-u old_version.c new_version.c>changes.patch# 应用补丁patch old_version.c<changes.patch

配置文件管理

# 比较配置文件diff-u /etc/config.old /etc/config.new# 备份并应用新配置cp/etc/config /etc/config.backupdiff-u /etc/config.backup /etc/config.new>config.patch patch /etc/config<config.patch

目录同步检查

# 检查两个目录是否同步diff-rq source_dir/ backup_dir/# 生成同步补丁diff-ru source_dir/ backup_dir/>sync.patch

自动化测试

# 验证输出文件是否匹配预期diff-q output.txt expected.txt&&echo"Test passed"||echo"Test failed"# 在脚本中使用ifdiff-q file1.txt file2.txt>/dev/null;thenecho"Files are identical"elseecho"Files differ"fi

六、常见问题

6.1 diff 输出格式看不懂？

问题：diff 的默认输出格式不够直观。

解决方案：

使用统一格式（unified format）：

# 使用 -u 选项显示统一格式diff-u file1.txt file2.txt# 使用 -c 选项显示上下文格式diff-c file1.txt file2.txt# 使用 -y 选项并排显示diff-y file1.txt file2.txt

6.2 如何忽略空白差异？

问题：只想比较实际内容，忽略空白字符的差异。

解决方案：

# 忽略行尾空白diff-b file1.txt file2.txt# 忽略所有空白diff-w file1.txt file2.txt# 忽略空行diff-B file1.txt file2.txt# 组合使用diff-wB file1.txt file2.txt

6.3 如何比较二进制文件？

问题：需要比较二进制文件或检测文件是否相同。

解决方案：

使用cmp命令：

# 快速检测是否相同cmp-s file1.bin file2.bin&&echo"Same"||echo"Different"# 显示第一个差异位置cmp-b file1.bin file2.bin# 显示所有差异cmp-l file1.bin file2.bin

6.4 如何解决合并冲突？

问题：使用 diff3 比较三个文件时，如何解决冲突。

解决方案：

# 生成合并结果diff3-m original.txt fileA.txt fileB.txt>merged.txt# 手动编辑 merged.txt 解决冲突# 冲突标记：# <<<<<<< fileA.txt# ... fileA 的内容 ...# =======# ... fileB 的内容 ...# >>>>>>> fileB.txt

6.5 diff 比较大文件很慢？

问题：比较大文件时，diff 执行很慢。

解决方案：

1. 使用 cmp 快速检测（如果只需要知道是否相同）：

   cmp-s large1.txt large2.txt

2. 限制比较范围：

   # 只比较前1000行head-1000 file1.txt>temp1.txthead-1000 file2.txt>temp2.txtdifftemp1.txt temp2.txt

3. 使用并行处理（如果比较多个文件对）：

   # 使用 xargs 并行处理find.-name"*.txt"|xargs-P4-I{}diff{}{}.bak

6.6 如何从源码构建 diffutils？

参考项目的构建脚本和文档：

# 1. 准备构建环境sudoaptupdate&&sudoaptinstall-y build-essential autoconf automake# 2. 下载源码gitclone https://github.com/Harmonybrew/ohos-diffutils.gitcdohos-diffutils# 3. 配置和编译./configure --host=aarch64-unknown-linux-ohosmake# 4. 安装makeinstall

七、总结与最佳实践

7.1 总结

diffutils 是强大的文件对比工具集，为鸿蒙PC提供了完整的文件比较和差异分析能力：

• ✅功能全面：diff、cmp、diff3、sdiff 四个工具覆盖各种比较需求
• ✅格式多样：支持多种输出格式，适应不同场景
• ✅高效算法：优化的算法快速处理大文件
• ✅标准兼容：完全符合 POSIX 标准

7.2 最佳实践

1. 选择合适的工具：

   • 文本文件比较使用diff
   • 快速检测文件是否相同使用cmp
   • 三路合并使用diff3
   • 并排查看使用sdiff

2. 使用合适的格式：

   • 生成补丁使用统一格式（-u）
   • 查看差异使用上下文格式（-c）
   • 直观查看使用并排格式（-y）

3. 忽略无关差异：

   • 使用-w忽略空白
   • 使用-B忽略空行
   • 使用-i忽略大小写

4. 生成和应用补丁：

   • 使用diff -u生成补丁
   • 使用patch应用补丁
   • 保留原始文件备份

5. 自动化脚本：

   • 使用退出码判断文件是否相同
   • 结合 find 和 xargs 批量比较
   • 在 CI/CD 中使用 diff 验证输出

7.3 适用场景

diffutils 特别适合以下场景：

• ✅版本控制：代码版本对比和补丁生成
• ✅代码审查：查看代码修改内容
• ✅配置管理：配置文件变更检查
• ✅文件同步：验证文件是否同步
• ✅自动化测试：验证输出是否匹配预期