本文作者:icy

Golang-wuzz:交互式 HTTP 调试利器 —— 用 Go 写的终端版 Postman

icy 今天 7 抢沙发
Golang-wuzz:交互式 HTTP 调试利器 —— 用 Go 写的终端版 Postman摘要: wuzz:交互式 HTTP 调试利器 —— 用 Go 写的终端版 Postman 前言 在 Web 开发与 API 调试的日常中,我们常常需要在 GUI 工具(Postman、In...

Golang-wuzz:交互式 HTTP 调试利器 —— 用 Go 写的终端版 Postman

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 环境)

Bash
go install github.com/asciimoo/wuzz@latest

2. 从 Releases 下载二进制

项目提供 Linux / macOS / Windows 的预编译版本,直接下载解压即可,适合没有 Go 环境的机器。

3. Arch Linux

Bash
yay -S wuzz

4. Homebrew(macOS)

Bash
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 文件:

Bash
wuzz --save myrequest.json

之后通过 -f 参数加载:

Bash
wuzz -f myrequest.json

这一特性使得API 调试可以沉淀为可复用的”请求脚本”,非常适合团队内分享接口调用样例。你甚至可以把它当作自动化测试的种子文件——写一个小脚本加载请求配置并发起断言。

💡 补充说明:网络上常有文章提到 wuzz -u <file> 加载请求,实际 wuzz 官方支持的加载参数为 -f,-u 并不存在。建议以官方 README 为准。

3.5 内置 Chrome DevTools 集成

这是 wuzz 相对其他 TUI 工具最独特的能力之一。它可以作为 Chrome 的调试代理,捕获浏览器发出的真实 HTTP 请求:

Bash
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 更轻。


七、使用小贴士

  1. 先按 F1:进入界面第一件事是看快捷键帮助,能省下大量摸索时间。
  2. 善用保存:把常用接口的请求存成 JSON,下次 -f 直接打开,比重新填一遍快得多。
  3. Proxy 标签页:在需要走公司代理或 Burp 抓包时,直接在界面里配置代理即可。
  4. Chrome 调试组合拳:配合 Chrome DevTools 的 Network 面板对照使用,可以快速区分”是浏览器行为”还是”是服务端返回”的问题。
  5. 留意版本:wuzz 相对较小众,快捷键与参数以你所用版本的 wuzz --help 与 README 为准。

结语

wuzz 不是最”主流”的 HTTP 工具,但它代表了一种坚持终端、坚持键盘、坚持轻量的极客美学。对于一个常年待在 SSH 会话或 tmux 里的 Go 开发者来说,它提供的是一种恰到好处的体验:既有结构化编辑请求的舒适,又有命令行工具的可移植性与可组合性。

如果你也曾为”在服务器上调试一个 POST 请求”而抓狂,或者想找一个小巧的工具练手阅读 Go TUI 项目源码,那么 wuzz 值得加入你的工具箱。

项目地址:https://github.com/asciimoo/wuzz

License:AGPL-3.0(注意:AGPL 对二次分发与网络服务有传染性要求,商用或二次分发前请阅读许可证条款。)

wuzz_20261110174306.zip
类型:压缩文件|已下载:0|下载方式:免费下载
立即下载
文章版权及转载声明

作者:icy本文地址:https://www.zelig.cn/golang/1515.html发布于 今天
文章转载或复制请以超链接形式并注明出处软角落-SoftNook

觉得文章有用就打赏一下文章作者

支付宝扫一扫打赏

微信扫一扫打赏

阅读
分享

发表评论

快捷回复:

评论列表 (暂无评论,7人围观)参与讨论

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