dffy
一个用 Rust 编写的 git 终端 diff 查看器。
专为大型仓库构建,最大可到 Linux 内核的规模。
dffy # everything you haven't committed
dffy main..HEAD # any revision git understands

安装
brew install --cask amalucelli/tap/dffy
# or
curl -fsSL https://raw.githubusercontent.com/amalucelli/dffy/main/install.sh | sh
# plus the experimental Markdown renderer: … | sh -s -- --plugin markdown
docs/install.md 涵盖 mise、从源码构建以及渲染器插件。然后在任意仓库中试用:dffy HEAD~10。
关于
dffy 是一个终端 diff 查看器。在 git 仓库中运行它,它会打开一个全屏视图来展示你的变更:左侧是文件树,右侧是 diff,可选择分栏或统一视图。通过管道调用时,它会改为直接打印 diff。
它是为大 diff 构建的。dffy 不会预先计算整个 diff,而是在找到第一批文件时就立即显示,并在后台处理其余部分,因此包含 13,000 个文件的变更可以像一行修复那样快速打开。
它适配你现有的工作方式。每个操作都只需按一个键,布局可从宽屏显示器一直适配到通过 SSH 连接的手机,并且 dffy 可以替代 git 的分页器、git add -p 过滤器和 difftool。设置保存在一个纯文本配置文件中,你可以把它和 dotfiles 放在一起。
为什么用 dffy
dffy 建立在我喜欢的工具之上:lumen 的终端审查流程、hunk 的审查用户体验,以及 diffs.com(Pierre 的 @pierre/diffs)的渲染方式。它们都不符合我的工作方式。lumen 以 AI 功能为中心,而我不希望在 diff 查看器里出现这些功能。hunk 是运行在 JavaScript 运行时上的 TypeScript,而我想要一个在超大仓库中依然保持快速的单个原生二进制文件。diffs.com 运行在浏览器中。所以我构建了一个原生终端 diff 查看器,它在笔记本电脑上和通过手机 SSH 连接时表现一致。
功能
- ⚡ 在 9.5ms 内打开 Linux v6.0..v6.1 的 diff,并在后台加载其余内容。
- 👀 --watch 会在你编辑、暂存和提交时重绘。
阅读 diff
- 🪟 分栏或统一视图,根据终端宽度选择。
- 🌈 支持 18 种语言的语法高亮,并强调变更的单词。
- 🌳 语法感知的 diff(d),会标记重新格式化(~)和移动(»)的代码。
- 🔁 按 git 的检测方式检测重命名。
- 🗂️
| dffy | hunk | lumen | difftastic | delta | diff-so-fancy | diff | |
|---|---|---|---|---|---|---|---|
| 带文件树的交互式查看器 | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ |
| 监听模式 | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ |
| git 的分页器(从 stdin 读取 diff) | ✅ | ✅ | ❌ | ❌ | ✅ | ✅ | ❌ |
| git add -p 过滤器 | ✅ | ❌ | ❌ | ❌ | ✅ | ✅ | ❌ |
| 语法高亮 | ✅ | ✅ | ✅ | ✅ | ✅ | ❌ | ❌ |
| 变更词强调 | ✅ | ✅ | ✅ | ✅ | ✅ | 🟡 | ❌ |
| 语法感知 diff | ✅ | ❌ | ❌ | ✅ | ❌ | ❌ | ❌ |
| 分栏与统一视图,按宽度选择 | ✅ | ✅ | ❌ | 🟡 | 🟡 | ❌ | 🟡 |
| 鼠标 | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ |
| 比较仓库外的文件 | ✅ | 🟡 | ❌ | ✅ | ✅ | 🟡 | ✅ |
| 插件或扩展 | 🟡 | 🟡 | ❌ | ❌ | ❌ | ❌ | ❌ |
| 单一原生二进制 | ✅ | 🟡 | ✅ | ✅ | ✅ | ❌ | ✅ |
| AI 或 agent 标注 | ❌ | ✅ | 🟡 | ❌ | ❌ | ❌ | ❌ |
| 其他 VCS(Jujutsu、Mercurial、Sapling) | ❌ | ✅ | ✅ | ✅ | ✅ | 🟡 | — |
🟡 表示部分支持;docs/benchmarks.md 对每一项都有说明。这七个都是开源的。GNU diff 采用 GPL-3.0-or-later,其余采用 MIT。对照的版本为 hunk 0.25.0、lumen 2.32.0、difftastic 0.72.0、delta 0.20.1、diff-so-fancy 1.4.14 和 GNU diffutils 3.10;docs/benchmarks.md 为每个单元格提供了来源链接。
Benchmarks
在查看器中打开 Linux v6.0..v6.1(13,168 个变更文件,48MB 补丁),从开始到第一行变更显示在屏幕上的时间:
| dffy | lumen 2.32.0 | hunk 0.25.0 | |
|---|---|---|---|
| v6.0..v6.1 范围 | 9.5ms | 12.4s | 17.7s |
| 工作树(5 个文件变更) | 63ms | 1.12s | 790ms |
| 作为分页器,git diff v6.0 v6.1 │ … | 217ms | n/a | 15.3s |
| 打开该范围的内存占用 | 90MB | 676MB | 4.26GB |
作为 git 的分页器时,dffy 以自身 3.0MB 的内存流式处理整个 48MB 补丁,速度与普通 git diff 相当。
docs/benchmarks.md 包含机器、方法、每条命令和完整结果,包括与 delta、diff-so-fancy 和 difftastic 的打印输出对比。
Architecture
dffy 用 Rust 编写。docs/architecture.md 涵盖各个 crate、数据流和引擎。
- 🧮 自有 diff 引擎:histogram 和语法感知 diff,重命名匹配方式与 git 一致。
- 🖼️ 自有终端渲染器,不使用 TUI 框架。渲染完整一帧约需 200µs。
- 🌊 流式输入和输出,因此首屏无需等待整个 diff。
- 🛰️ 每个仓库共享一个监听器,无论打开多少个视图。
Docs
docs/ 涵盖每个按键、标志和设置:用法、查看器、按键、配置、主题、git 集成、监听模式、渲染器插件、故障排除、架构和基准测试。