Newshot

Dffy:一款用 Rust 编写的快速终端原生 Git diff 查看器

Translation(model translation, not the source's own text)

dffy

一个用 Rust 编写的 git 终端 diff 查看器。

专为大型仓库构建,最大可到 Linux 内核的规模。


        dffy                   # everything you haven't committed
dffy main..HEAD        # any revision git understands
      
dffy 正在查看 Linux v6.0..v6.1 的 diff
dffy 正在查看 Linux v6.0..v6.1 的 diff

安装


        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 的检测方式检测重命名。
  • 🗂️
dffyhunklumendifftasticdeltadiff-so-fancydiff
带文件树的交互式查看器✅✅✅❌❌❌❌
监听模式✅✅✅❌❌❌❌
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 补丁),从开始到第一行变更显示在屏幕上的时间:

dffylumen 2.32.0hunk 0.25.0
v6.0..v6.1 范围9.5ms12.4s17.7s
工作树(5 个文件变更)63ms1.12s790ms
作为分页器,git diff v6.0 v6.1 │ …217msn/a15.3s
打开该范围的内存占用90MB676MB4.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 集成、监听模式、渲染器插件、故障排除、架构和基准测试。

License

The translation is machine-generated and individual terms may be off. Nothing is rewritten or cut; the original is authoritative.

Published by Hacker News
This site only summarises and aggregates; copyright stays with the original author. Headlines and summaries follow the source — where they differ, the original wins.
Read the original ↗