Rust 实现的内容感知 diff 工具 OmniDiff 的性能与使用方法

仅移动了函数的位置，但在代码审查界面上却列出了冗长的删除与新增记录；而图像变更有时仅以“文件已更改”这一行结束。在这种情况下，迅速把握“变更了什么”比统计变更行数更为重要。

用Rust开发的OmniDiff通过比较代码的语法结构，并对图像、字体、PDF等文件采用符合各自格式的比较方式。本文将基于官方文档和公开演示，探讨如何在现有Git工作流程中加以利用。 ¹

OmniDiff的核心技术：基于Rust的结构识别与非文本文件支持

代码比较的结构化识别 OmniDiff通过Tree-sitter解析器将C、C++、Go、Python、Rust、TypeScript等共计25种语言的源代码解析为语法树 ², ¹。其中的核心技术是高效实现了APTED（Advanced Post-order Traversal Edit Distance）树diff算法 ³。现有的基于文本的diff会将移动的代码识别为“删除后插入”，而OmniDiff通过分析语法树的结构变化，能够识别出代码实际发生了移动（Moved） ³。

源代码的语言类型通过文件扩展名进行检测。相比之下，非文本文件则不是通过文件名，而是通过实际字节来识别格式。区分这两条路径，才能准确理解其支持范围。 ¹

非文本文件的内容单位分析 对于除文本代码外的二进制文件，根据内容特性按如下方式进行比较 ², ¹, ⁴。

• 图像：对PNG、JPEG、GIF等图像进行像素级比较。特别是对于动画GIF，会具体报告帧数的增加（例如从5帧增加到7帧）或逐帧的变更情况 ², ⁴。
• 字体：在TrueType、OpenType、WOFF2等字体文件中渲染字形，跟踪特定图标（例如U+0021）的像素变化率及度量信息的变化 ¹, ⁴。
• 归档文件：打开ZIP、JAR、EPUB、Office文档（ODT）等容器格式文件的内部结构，仅提取并分析发生更改的组件。嵌套压缩文件也按组件分别进行比较 ², ⁴。
• PDF：通过渲染页面来识别视觉变更，并区分记录元数据更改与页面渲染差异 ², ⁴。

实测性能基准：处理速度与精确度

以下数据为项目开发公布的测量结果。本文并未单独重新进行性能测试。比较对象和数据集不同，结果也会随之变化。

在Hacker News的讨论中，开发者公布了Difftastic与OmniDiff共同支持的代码案例的比较数据。根据该数据，OmniDiff的中位数（p50）处理速度为4ms，比Difftastic的35ms快约8倍以上 ³。

仅在与Difftastic支持范围重叠的代码变更中进行比较时，OmniDiff与人工判断标准“完美匹配（perfect）”的比例为90%，精确度高于Difftastic的64% ³。

上述90%仅限于与Difftastic支持范围重叠的比较。在GeekNews上整理的另一项整体代码准确性评估中，--minimal 基准下的完全匹配率为69.6%。不应将这两个数值视为同一评估结果。 ²

目前的误差主要并非源于匹配算法本身，而是产生于屏幕上如何高亮显示变更内容的渲染规则 ²。

开发者工作流集成：TUI、CLI及编辑器联动

OmniDiff同时支持交互式终端UI（TUI）和用于脚本的纯文本输出，可灵活应用于各种开发环境。

版本控制系统（Git、Jujutsu）联动 交互式Git查看器需先通过 omnidiff git configure 进行设置，然后通过 git difftool 打开。GIT_EXTERNAL_DIFF=omnidiff git diff 是用于纯文本输出的联动设置 ², ¹。如果仅输入 git diff，在分页器环境中不会启动交互式TUI，而是以纯文本模式（headless mode）输出结果 ², ¹。对于Jujutsu (jj)，可以通过专用的设置向导配置为文件级调用（file-by-file）模式，从而完整使用语言检测功能 ², ¹。

安装后，可以直接比较两个文件，或运行Git设置向导。在向导中选择当前仓库或全局应用范围。 ¹

omnidiff BEFORE AFTER
omnidiff git configure
git difftool

输出格式及审查工具

• 终端查看器 (TUI)：支持亮色和暗色主题，并通过24位颜色或终端图形协议（kitty、sixel等）在屏幕上以实际图像形式输出图片 ², ¹。
• 自动化/脚本：--headless 输出纯文本，当标准输出不是终端时也会自动切换到此模式。JSON输出则需单独使用 omnidiff --mode json BEFORE AFTER ², ¹。
• 浏览器审查：通过目前仍处于 v0.0.0 阶段的早期项目 codereview，也可以在Web浏览器环境中审查变更内容 ², ¹。

编辑器插件 提供适用于VS Code和Neovim的插件（omnidiff-vscode、omnidiff.nvim），并通过Open VSX支持在Cursor、VSCodium等环境中安装和使用 ², ¹。

OmniDiff的技术限制与项目现状

需要区分用于比较内容的查看器和用于解决合并冲突的工具。 最主要的课题是不支持 3方向合并 (3-way merge)。APTED算法基本上针对2方向比较进行了优化，因此用于解决合并冲突（conflict）的3方向diff功能是开发者表示未来希望解决的课题 ³。 README中说明，为了保持开发速度，目前不接受外部贡献 ², ¹。开发过程中使用了AI代理（Claude Code），并采用AGPL-3.0-only许可证 ², ¹。建议先在公开演示中查看自己经常遇到的变更类型，并用两个熟悉的文件比较结果。对于经常发生代码移动或图像、字体变更的仓库，容易确认其与一般的行级比较有何不同。