如何优雅审阅GitHub PR?diffnav一行命令打开PR diff并查看review评论

原创2026-10-11 15:58:551,853 阅读

如何优雅审阅GitHub PR?diffnav一行命令打开PR diff并查看review评论

diffnav 是一款基于 delta 的 git diff 终端分页器(pager),最大特色是为你的 diff 加上了 GitHub 风格的文件树。用一行命令就能打开 GitHub PR 的完整 diff,左侧文件树跳转、右侧并排对比,还能拉取 PR 的 review 评论线程,让代码审阅彻底告别浏览器标签页。

diffnav终端git diff分页器带文件树浏览PR diff与review评论

为什么要在终端里审阅 PR?

大多数人在审阅 PR 时的体验是:浏览器里一页页滚动 diff,来回切换文件和聊天窗口,长 PR 看下来眼睛和注意力都疲惫不堪。

diffnav 的思路很简单:把 PR diff 完整拉下来,扔进终端里的 TUI(终端图形界面)里:

  • 🌲 左侧文件树:按目录组织所有改动文件,一眼看清改动范围,单链目录还会自动折叠
  • 🔀 右侧 diff 视图:基于 delta 渲染,支持并排(side-by-side)/统一(unified)两种视图,带行号、语法高亮
  • ⚡ 键盘流操作:文件间跳转、搜索、切主题,全程不碰鼠标

它的 diff 渲染由 delta 驱动,cfg/delta.conf 里可以看到内置的行号、增删行配色等样式配置。

30秒快速安装

Homebrew(macOS / Linux):

brew install diffnav

Go 源码安装:

git clone https://gitcode.com/gh_mirrors/di/diffnav
cd diffnav
go install .

💡 小提示:想看到漂亮的文件图标,建议给终端装一套 Nerd Font 字体并设置为默认字体。

一行命令打开 GitHub PR diff

方式一:管道模式

如果你习惯用 GitHub CLI,把 gh pr diff 的输出管道给 diffnav 即可:

gh pr diff https://github.com/dlvhdr/gh-dash/pull/447 | diffnav

普通 git diff 同样适用:

git diff | diffnav

方式二:--pr 参数直接加载 PR

也可以把 PR 链接直接交给 diffnav,它会自动完成 diff 拉取:

diffnav --pr https://github.com/dlvhdr/gh-dash/pull/447

--pr 参数定义在 cmd/root.go,启动时 diffnav 会并行发起两类请求(见 pkg/ui/tui.go):

数据 说明 实现
PR 的 diff 内容 通过 REST API 以 application/vnd.github.v3.diff 格式拉取完整补丁 FetchPRDiff
PR 元信息与 review 线程 通过 GraphQL API 拉取 PR 标题、分支、评论线程等 FetchPR

其中 review 评论线程的数据结构在 ReviewThread 中定义,包含每条评论的正文、作者、时间,以及 isResolved(是否已解决)、isOutdated(代码是否已过期)等状态——测试样例 prComments.json 里可以看到真实的评论线程长什么样。这样你在终端里就能同时掌握"改了什么"和"大家评了什么",不用切回浏览器。

注意:拉取 PR 数据需要已登录的 GitHub 凭据(如通过 gh auth login 配置好),私有仓库同样适用。

文件树导航:告别逐行滚动

PR 动辄几十上百个文件时,文件树就是核心生产力。进入 diffnav 后常用按键:

按键 功能
j / k 下一个 / 上一个节点
n / p 跳到下一个 / 上一个文件(自动跳过目录)
g / G 跳到顶部 / 底部
t 搜索/过滤文件名,回车直达目标文件
e 收起/展开文件树,全屏看 diff
s 切换 并排 / 统一 视图
/ 在 diff 内容中搜索
y 复制当前文件路径
o 用 $EDITOR 打开当前文件
T 打开主题选择器
F1 / ? 查看完整帮助
q 退出

这些键位集中定义在 pkg/ui/keys.go,底部状态栏常驻显示,随时按 ? 唤起帮助面板。文件树的单链目录自动折叠逻辑(比如 a/b/c 折叠成 a/b/c)实现在 filetree.go。

🖱️ 也支持鼠标:直接点击文件、滚轮滚动,甚至能拖拽调整文件树宽度。

Watch 模式:边改边看

本地开发时不想反复手动跑 git diff?开启 watch 模式,diffnav 会周期性重跑命令并自动刷新画面:

# 默认每 2 秒刷新 git diff
diffnav --watch

# 监控暂存区变更,5 秒刷新一次
diffnav --watch-cmd "git diff --cached" --watch-interval 5s

刷新间隔等参数在 cmd/root.go 中定义,底层调度逻辑见 pkg/watch/watch.go。

个性化配置与主题

diffnav 读取 ~/.config/diffnav/config.yml(macOS 上为系统配置目录),常用选项见 pkg/config/config.go:

ui:
  hideHeader: false        # 隐藏顶部标题栏,给 diff 更多空间
  showFileTree: true       # 启动时是否显示文件树
  fileTreeWidth: 30        # 文件树宽度
  sideBySide: true         # 并排视图(false 为统一视图)
  startFoldersOpenDepth: 1 # 启动时展开的目录层级(-1 全展开)
  theme: tokyo_night       # 主题(默认 tokyo_night)

主题也可以随时按 T 在界面里预览切换,不用改配置文件。图标样式支持 nerd-fonts / unicode / ascii 多种风格,按 i 循环切换。

设为全局 git diff 分页器

如果你受够了默认 less 的 diff 输出,一条命令让所有 git diff / git log -p 都走 diffnav:

git config --global pager.diff diffnav

以后任何 diff 场景都会自动带上文件树和语法高亮。

总结

场景 命令
审阅 GitHub PR diffnav --pr <PR链接>
配合 GitHub CLI gh pr diff <链接> | diffnav
本地变更 git diff | diffnav
实时监控变更 diffnav --watch
全局替换 diff 分页器 git config --global pager.diff diffnav

diffnav 用极低的切换成本,把"文件树 + delta 渲染 + review 评论"三件套搬进了终端。如果你每天要跟 PR diff 打交道,强烈建议装一个试试——装完大概率就回不去了。

更多细节可参考项目说明 README.md 与示例 diff 文件 examples/。

登录后查看全文
diffnav