返回资讯中心
外部精选
软件工程
#开发者实时流

diffs-rs 发布高性能终端 diff 渲染器

来源标题:Show HN: Performance-driven terminal diff renderer

diffs-rs 发布了一个终端 diff 查看器及可嵌入 Ratatui 的 Rust diff 引擎,能渲染同类库无法处理的大型 diff,且内存占用可控。用户可通过 cargo install diffs-rs 安装,支持补丁文件、stdin、两文件对比及 git 提交对比。该工具不修改仓库或工作区,也不发起网络请求。

Hacker News 最新ramoz2026/11/15 · 2 天前12 分钟阅读

以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。

一个快速的终端 diff 查看器,以及它背后的 Rust diff 引擎,你可以把它嵌入到 Ratatui 应用中。 cargo install diffs-rs --locked 这会安装 diffs 二进制文件。构建需要 Rust 1.88 或更新版本,以及一个 C 编译器用于内置的 libgit2。 diffs patch changes.patch # 一个补丁文件 git diff --no-color | diffs patch - # 从标准输入读取补丁 git log -p -3 --no-color | diffs patch - # git show、log -p 和 format-patch 的输出均可 diffs files old.rs new.rs # 两个文件 diffs git --repo . --base main --head HEAD # 两个提交,逐树比较 diffs --layout unified --theme light patch changes.patch --layout 可选 auto、split 或 unified;--theme 可选 dark 或 light。--sidebar 和 --no-sidebar 用于覆盖变更文件侧边栏的显示。diffs files 和 diffs git 接受 --check, 用于校验每个源字节并打印 JSON 报告,而不是打开查看器。在查看器中按 ? 可查看所有按键绑定。 diffs 绝不修改仓库、索引或工作树,也不发起任何网络请求。 支持 split 和 unified 布局、自动换行、行号,以及深色和浅色主题。 为内置语法提供语法高亮,并支持变更词强调。 对于文件和 git,颜色基于完整的旧源和新源计算,未变更的间隙可以每次展开 20 行。 变更文件侧边栏,显示补丁的目录树以及每个文件和每个文件夹的计数。 大型补丁逐步打开;第一屏在其余部分仍在索引时就会显示。 在整个 diff 中进行字面搜索(/、F3)。 源代码行选择(V)、保存原始字节(Ctrl-S)以及纯文本复制(y,macOS)。 鼠标支持:滚轮滚动,点击文件、文件夹和上下文间隙。 性能 在 Linux v6.0...v7.0 补丁(711 MB,76,872 个文件,421,819 个 hunk)上: 第一个原型在同一补丁上使用了 2,590 MiB,并且仍然无法打开它。时间是 Apple M5 Max 上五个全新进程的中位数,文件缓存已预热,在正确输出到达 160 x 50 PTY 时测量,基于预发布构建。测量页面包含全部五个测试补丁、方法以及开放内存目标。 [dependencies] diffs-rs = { version = "0.1", default-features = false } anyhow = "1" ratatui = { version = "0.30.2", default-features = false, features = ["crossterm"] } 宿主拥有终端和事件循环。引擎在后台线程中加载并为审查内容着色,并绘制到任意 Rect: use std::{sync::mpsc, time::Duration}; use diffs_rs::engine::{Engine, Input, Options}; use ratatui::crossterm::event::{self, Event, KeyCode}; fn main() -> anyhow::Result<()> { let mut terminal = ratatui::init(); // 当后台工作就绪时,引擎会在此通道上发送提示。 let (wake, woken) = mpsc::sync_channel(1); let input = Input::Patch("changes.patch".into()); let mut engine = Engine::open(input, Options::default(), wake)?; let result = (|| -> anyhow::Result<()> { loop { let _ = woken.try_recv(); engine.poll()?; if engine.needs_draw() { let mut drawn = Ok(()); terminal.draw(|frame| { let area = frame.area(); drawn = engine.draw(frame, area); })?; drawn?; engine.after_draw(); if event::poll(Duration::from_millis(16))? { let event = event::read()?; if matches!(&event, Event::Key(key) if key.code == KeyCode::Char('q')) { return Ok(()); engine.handle_event(event, true)?; })(); // 汇合后台工作线程并报告清理错误。 let closed = engine.close(); ratatui::restore(); result.and(closed) Input 还接受打开的流、两个文件或两个 Git 提交。嵌入指南涵盖宿主循环、焦点、源坐标、阅读工具和关闭流程。examples/embedded_viewer.rs 是一个完整的宿主示例,在查看器旁边拥有自己的面板。 仅限 Unix:查看器需要 PTY、/dev/tty 和 Unix 信号。Apple 芯片上的 macOS 是测试最多的平台。Linux 在 CI 中运行完整测试套件。不支持 Windows。 diffs files 和 diffs git 需要 Git 2.50 或更新版本。 语法高亮使用三个 crate 的分支版本,分别发布为 diffs-syntect(syntect 5.3.0)、diffs-fancy-regex(fancy-regex 0.16.2)和 diffs-two-face(two-face 0.5.2,针对 diffs-syntect 重新构建)。这些补丁在相同的语法模式之间共享编译后的正则引擎,在行内复用搜索缓冲区,并跳过因行中缺少所需字节而无法匹配的搜索。匹配结果保持不变。在测试跟踪中,这将实时堆内存从 275 MiB 降低到 213 MiB,并将首次访问的深层文件着色时间减半,从 1,494 ms 降至 752 ms。这些分支是为 diffs-rs 而存在的;其他项目应使用上游 crate。 Apache-2.0。参见 LICENSE。内置主题和分支 crate 保留各自的许可证,列于 NOTICE.md 中。

正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。

打开原文
去社区讨论 →