如何优雅审阅GitHub PR?diffnav一行命令打开PR diff并查看review评论
如何优雅审阅GitHub PR?diffnav一行命令打开PR diff并查看review评论
diffnav 是一款基于 delta 的 git diff 终端分页器(pager),最大特色是为你的 diff 加上了 GitHub 风格的文件树。用一行命令就能打开 GitHub PR 的完整 diff,左侧文件树跳转、右侧并排对比,还能拉取 PR 的 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 打交道,强烈建议装一个试试——装完大概率就回不去了。
