wuzz:交互式 HTTP 调试利器 —— 用 Go 写的终端版 Postman
前言
在 Web 开发与 API 调试的日常中,我们常常需要在 GUI 工具(Postman、Insomnia)和命令行(curl)之间来回切换。GUI 工具功能强大但笨重,命令行灵活却难以浏览和修改请求。有没有一种工具既能拥有终端的高效,又能提供交互式的请求浏览与编辑体验?
答案是 wuzz——一个用 Go 编写的、运行在终端里的交互式 HTTP 请求调试工具。项目地址:github.com/asciimoo/wuzz。
可以把它理解为”终端里的 Postman”,或者”带 UI 的 curl”。
一、项目概览
| 特性 | 说明 |
|---|---|
| 语言 | Go(编译为单一静态二进制,无运行时依赖) |
| 许可证 | AGPL-3.0 |
| 作者 | asciimoo(同时也是搜索引擎 searx 的作者) |
| 交互方式 | 全键盘操作,基于 tview 库构建的 TUI 界面 |
| 调试能力 | 内置 Chrome DevTools Protocol 集成,可拦截浏览器请求 |
wuzz 的设计哲学很纯粹:请求即配置。每一次 HTTP 请求都由 URL、方法、Header、Body、查询参数等结构化的字段组成,你可以在 TUI 中自由编辑、发送、查看响应,并把整段请求持久化为一个配置文件。
二、快速安装
得益于 Go 的生态,安装方式非常灵活:
1. 通过 go install(需要 Go 环境)
go install github.com/asciimoo/wuzz@latest
2. 从 Releases 下载二进制
项目提供 Linux / macOS / Windows 的预编译版本,直接下载解压即可,适合没有 Go 环境的机器。
3. Arch Linux
yay -S wuzz
4. Homebrew(macOS)
brew install wuzz
安装完成后,直接运行 wuzz 便会进入交互式界面。
三、核心功能解析
3.1 交互式 TUI:请求与响应的双栏视图
启动 wuzz 后,终端会呈现一个分栏界面:
- 左侧/上半区:请求编辑器,分为 URL、Method、Header、Body、Query Params、Search 等多个可切换标签页;
- 右侧/下半区:响应查看器,支持 Raw、Headers、Body、Preview 等视图切换。
所有操作都是快捷键驱动:
F1帮助,随时查看快捷键列表;Tab/Shift+Tab在 URL、方法、Header、Body 之间切换焦点;Ctrl+R发送请求;↑/↓浏览历史记录;Esc退出。
这种布局借鉴了经典 Vim 与浏览器 DevTools 的体验,熟悉之后效率极高。
3.2 结构化地编辑 HTTP 请求
与 curl 那种”一行命令塞满参数”的方式不同,wuzz 把每个请求要素都拆成独立可编辑的字段:
- Method:点击即可通过下拉菜单选择 GET/POST/PUT/DELETE/PATCH 等;
- URL:支持
http://与https://; - Header:以
Key: Value的表格形式逐行编辑; - Body:多行文本编辑,适合 JSON、表单、XML;
- Query Params:可视化地增加、删除、修改 URL 查询参数,自动 URL 编码;
- Basic Auth、Proxy、Timeout 等也可在对应标签页设置。
这种”所见即所发送”的方式大幅降低了手写请求时的出错率。
3.3 快捷键驱动的响应浏览
响应返回后,你可以在多个视图中快速切换:
- Raw:原始 HTTP 响应;
- Headers:响应头解析后展示;
- Body:响应体;
- Preview:如果是 HTML 或 JSON,会自动格式化预览(JSON 会被美化)。
对于排查接口问题时,这比滚动 curl -v 的输出要清爽得多。
3.4 请求持久化:保存与加载
在界面上按 Ctrl+S 可以将当前请求保存为一个 JSON 文件:
wuzz --save myrequest.json
之后通过 -f 参数加载:
wuzz -f myrequest.json
这一特性使得API 调试可以沉淀为可复用的”请求脚本”,非常适合团队内分享接口调用样例。你甚至可以把它当作自动化测试的种子文件——写一个小脚本加载请求配置并发起断言。
💡 补充说明:网络上常有文章提到
wuzz -u <file>加载请求,实际 wuzz 官方支持的加载参数为-f,-u并不存在。建议以官方 README 为准。
3.5 内置 Chrome DevTools 集成
这是 wuzz 相对其他 TUI 工具最独特的能力之一。它可以作为 Chrome 的调试代理,捕获浏览器发出的真实 HTTP 请求:
wuzz --debug-chrome
启动后,wuzz 会引导你以特定的调试端口启动 Chrome。随后在 Chrome 里发起任意请求,wuzz 都能拦截并展示完整请求,你可以在 wuzz 里修改 Header、Body 或 URL 后重新发送,无需回到代码里改动。
这为前端联调、复现 bug、逆向分析场景提供了极高效的工作流。
四、典型使用场景
场景一:快速探索陌生 API
拿到一份接口文档,想先跑通几个请求。用终端启动 wuzz,逐个尝试 endpoint,一边修改 Header 一边观察响应,不需要在 Postman 里点来点去。
场景二:调试跨域、鉴权类问题
把请求原封不动地从浏览器复制到 wuzz,在 Header 里逐步移除或修改 Origin、Cookie、Authorization,快速定位是哪一项导致服务端拒绝。
场景三:CI / 服务器环境下的调试
服务器通常只有 SSH 环境,无法运行 GUI 工具。wuzz 是静态二进制,scp 上去即可用,是排查线上接口问题的利器。
场景四:把接口调用”代码化”
保存请求为 JSON,纳入版本管理,作为 API 的”可执行文档”或手工回归测试清单。
五、架构与实现浅析
作为 Go 开发者,wuzz 的源码也值得一读。它规模不大(几千行),结构清晰:
- UI 层:基于
tview+tcell,构建跨平台的终端界面; - 网络层:直接使用标准库
net/http,把 UI 中的结构化字段映射成http.Request,天然支持 HTTP/2、代理、TLS; - DevTools 协议:通过 WebSocket 与 Chrome 的 DevTools 通信,接收
Network.requestWillBeSent等事件; - 配置持久化:请求与响应以 JSON 序列化,便于阅读与手改。
这种“TUI 前端 + 标准库网络层”的分层设计,是学习如何用 Go 写出高质量终端应用的优秀范例。如果你想自己开发类似工具,wuzz 是很好的参考起点。
六、wuzz vs 其他工具
| 工具 | 交互方式 | 优点 | 不足 |
|---|---|---|---|
| curl | 命令行 | 通用、可脚本化 | 参数繁杂,不擅长浏览响应 |
| Postman | GUI | 功能全、团队协作强 | 重、需图形环境 |
| httpie | 命令行 | 语法优雅、可读性强 | 仍是命令行,无交互式编辑 |
| wuzz | TUI | 交互+终端,轻量、可持久化、可拦截 Chrome | 学习快捷键有成本,无协作功能 |
wuzz 的定位恰好填补了 curl 与 Postman 之间的空白:比 curl 更好用,比 Postman 更轻。
七、使用小贴士
- 先按 F1:进入界面第一件事是看快捷键帮助,能省下大量摸索时间。
- 善用保存:把常用接口的请求存成 JSON,下次
-f直接打开,比重新填一遍快得多。 - Proxy 标签页:在需要走公司代理或 Burp 抓包时,直接在界面里配置代理即可。
- Chrome 调试组合拳:配合 Chrome DevTools 的 Network 面板对照使用,可以快速区分”是浏览器行为”还是”是服务端返回”的问题。
- 留意版本:wuzz 相对较小众,快捷键与参数以你所用版本的
wuzz --help与 README 为准。
结语
wuzz 不是最”主流”的 HTTP 工具,但它代表了一种坚持终端、坚持键盘、坚持轻量的极客美学。对于一个常年待在 SSH 会话或 tmux 里的 Go 开发者来说,它提供的是一种恰到好处的体验:既有结构化编辑请求的舒适,又有命令行工具的可移植性与可组合性。
如果你也曾为”在服务器上调试一个 POST 请求”而抓狂,或者想找一个小巧的工具练手阅读 Go TUI 项目源码,那么 wuzz 值得加入你的工具箱。
项目地址:https://github.com/asciimoo/wuzz
License:AGPL-3.0(注意:AGPL 对二次分发与网络服务有传染性要求,商用或二次分发前请阅读许可证条款。)




还没有评论,来说两句吧...