Hoppscotch

Hoppscotch — 一个轻量级、开源的API测试工具，帮你像用Postman一样调试接口，但更快、更干净。

最近在折腾几个新项目的API对接，发现Postman越来越臃肿了——每次打开都要等半天，界面里塞满了团队协作、文档生成、监控报警这些我根本用不上的功能。我只是想快速发个请求看看返回数据啊！于是翻了一圈替代品，找到了 Hoppscotch，用了两周直接卸载了Postman。

这玩意儿到底啥来头？简单说，它就是一个开源的、基于Web的API请求调试器，长得像Postman的轻量版，但核心体验完全不一样：打开浏览器就能用，不需要注册账号，没有Electron的臃肿外壳，响应速度飞起。如果你只是需要快速测试GET/POST请求、检查JSON返回、或者调试GraphQL接口，Hoppscotch简直是为这种场景量身定做的。

它能干点啥？

• 基础HTTP请求：GET、POST、PUT、PATCH、DELETE、HEAD、OPTIONS，一个不落。支持自定义Headers、Body（JSON/Form-Data/二进制/Binary）、Query参数。
• 环境变量：像Postman一样设置变量，比如 {{base_url}} 这种，方便在不同环境（开发、测试、生产）切换。
• 集合管理：把相关请求分到不同集合里，存成JSON文件或同步到Git仓库（没错，它用Git来管理历史，而不是云数据库）。
• GraphQL支持：直接写GraphQL查询，自动补全schema（需要后端暴露introspection）。
• WebSocket / SSE / Socket.IO：实时调试WebSocket连接，看消息推送，这功能Postman要Pro版才有。
• 暗色模式 + 快捷键：开发者该有的都有，按 Ctrl+K 能快速搜索所有请求。

最骚的是它完全开源，代码在GitHub上挂着，你可以自己部署到服务器上，数据全在自己手里，不用担心隐私问题。

怎么下载？

别被“在线工具”四个字骗了——它虽然可以在浏览器里直接用，但如果你经常断网或者想要本地离线的体验，我建议你下载桌面版。桌面版本质上是把Web应用包在了一个轻量外壳里，但能避免浏览器跨域限制（比如自动处理CORS预检请求），而且启动速度比Postman快一个量级。

下载地址：Hoppscotch官网
官网首页就有大大的“Download”按钮，支持Windows、macOS、Linux（.AppImage/.deb/.rpm）。如果你懒得装客户端，也可以直接用浏览器打开 https://hoppscotch.io/ 在线版，功能几乎一样，只是不能离线用。

另外，如果你熟悉Docker，可以直接拉镜像自己部署：

docker run -p 3000:3000 hoppscotty/hoppscotch

部署到内网后团队一起用，数据不经过第三方，安全得很。

安装方法

Windows用户：下载 .exe 安装包，双击一路下一步，完事儿。注意如果提示“Windows protected your PC”，点“More info”然后“Run anyway”，因为它是开源软件没买微软的签名证书。

macOS用户：下载 .dmg 文件，拖到Application文件夹。第一次打开可能提示“无法验证开发者”，去系统设置-隐私与安全性里点“仍要打开”。或者用Homebrew装：

brew install --cask hoppscotch

Linux用户：下载 .AppImage，给执行权限后直接运行：

chmod +x Hoppscotch-*.AppImage
./Hoppscotch-*.AppImage

或者用Snap：

snap install hoppscotch

装完后打开，界面干净得像一张白纸——左边是请求列表，中间是请求编辑区，右边是响应面板，没有广告没有弹窗。

基础使用教程

1. 发一个最简单的GET请求
打开软件，在中间顶部的地址栏输入 https://api.github.com/users/octocat，方法选 GET，然后点右侧的“Send”按钮（或者按 Ctrl+Enter）。几毫秒后右边就会显示响应状态码、Headers、JSON数据。看，就这么简单，不需要创建项目、不需要登录。

2. 带参数的POST请求
假设你要测试登录接口：

• 方法选 POST
• URL填 https://example.com/api/login
• 点“Headers”标签，加一行 Content-Type: application/json
• 点“Body”标签，选 JSON，然后输入：

{
  "username": "test",
  "password": "123456"
}

• 点发送，看返回的token或者错误信息。

3. 保存请求到集合
点地址栏左边的“Save”按钮（或者按 Ctrl+S），会弹出一个对话框让你选集合。如果没有集合，点“New Collection”创建一个，比如叫“我的API测试”。以后所有请求都能分类管理，还能导出成JSON文件分享给同事。

4. 使用环境变量
点右上角的“环境”图标（像个小齿轮），新建一个环境，比如“开发环境”，然后添加变量：

• base_url = http://localhost:3000
• token = your_dev_token
  之后在URL里写 {{base_url}}/users，在Headers里写 Authorization: Bearer {{token}}，发送请求时就会自动替换。切换环境只需下拉选择，比Postman的变量管理更直观。

进阶技巧

1. 用快捷键起飞
Hoppscotch的快捷键设计得很合理，我常用的几个：

• Ctrl+Enter：发送请求
• Ctrl+K：全局搜索请求（比用鼠标点快10倍）
• Ctrl+Shift+S：保存当前请求到集合
• Ctrl+/：切换注释/取消注释（在编辑JSON Body时超好用）
  在设置里能看到所有快捷键列表，建议花5分钟记一下。

2. 用Pre-request Script做动态参数
虽然Hoppscotch不像Postman那样支持完整的JavaScript脚本，但它支持在请求前执行简单的表达式。比如你想生成一个时间戳作为参数，可以在URL里写 ?timestamp={{$timestamp}}，它会自动替换成当前Unix时间戳。类似的还有 {{$uuid}}、{{$randomInt}}。更复杂的逻辑？目前不支持，但官方说在开发中。

3. 用GraphQL调试接口
如果你在用GraphQL，点左边菜单的“GraphQL”标签，输入Endpoint（比如 https://api.github.com/graphql），然后在下方写Query。最爽的是，如果后端开启了introspection，点“Docs”按钮就能看到完整的Schema结构，字段说明、参数类型一目了然，省得自己翻文档。

4. 用WebSocket实时调试
左边菜单选“WebSocket”，输入ws地址（比如 wss://echo.websocket.org），点连接，然后就能在下方输入消息并实时看到返回。这个功能对调试聊天应用、实时推送服务非常有用，Postman的WebSocket支持要付费版才有。

5. 用“代码生成”快速复制到其他语言
当你调试好一个请求后，点响应面板右上角的“Code”按钮（像个 </> 图标），它会自动生成对应语言的代码片段——支持cURL、Python Requests、JavaScript Fetch、Java OkHttp、Go、Swift等十几种语言。比如你调好了接口，直接点“Python”复制代码，粘贴到爬虫脚本里就能用。

6. 自托管团队协作
如果你不想把数据存在第三方，可以用Docker在自己的服务器上部署Hoppscotch。部署后团队成员通过浏览器访问内网地址，所有请求集合、环境变量都存在自己的服务器上。配合Git同步，每次修改都能版本控制，回滚也方便。适合对数据安全要求高的团队。

一点小吐槽

Hoppscotch也不是完美的。它的插件生态几乎为零，不像Postman有那么多第三方集成（比如和Swagger、GitHub的联动）。文档也比较简陋，很多高级功能得自己摸索。另外，团队协作功能目前只支持通过Git同步，实时协作（像Postman的多人编辑）还没有。但如果你只是一个人调试API，或者团队规模小、不需要复杂的工作流，它完全够用。

总结

Hoppscotch给我的感觉就是“返璞归真”——没有花里胡哨的营销功能，把发请求、看响应这件事做到极致。如果你受够了Postman的启动速度和内存占用，或者厌倦了每次打开都要登录的麻烦，试试Hoppscotch。它可能不会让你惊艳，但用久了你会发现：原来调试API可以这么干净利落。

最后，别忘了去GitHub给它点个Star——毕竟开源项目靠的就是社区支持。