Hoppscotch：三步装好免费上手的开源 API 测试工具

Hoppscotch：三步装好免费上手的开源 API 测试工具

【免费下载链接】hoppscotchOpen-Source API Development Ecosystem • https://hoppscotch.io • Offline, On-Prem & Cloud • Web, Desktop & CLI • Open-Source Alternative to Postman, Insomnia项目地址: https://gitcode.com/GitHub_Trending/ho/hoppscotch

Hoppscotch 是一款免费开源的 API 测试工具。支持 REST、GraphQL、WebSocket、MQTT，还能导入 Postman 集合。Web、桌面、移动都能跑。适合需要快速调试接口的开发者，也适合要共享 API 文档的团队。

🚀 三步跑起来

最短路径选 Web 版。不装客户端，不注册账号，克隆、装依赖、启动，完事。

git clone https://gitcode.com/GitHub_Trending/ho/hoppscotch cd hoppscotch pnpm install pnpm dev

验收标准：浏览器打开 http://localhost:4173，看到 "REST" 请求栏和左侧集合面板，就算成功。

一个提醒：这个项目锁定 pnpm。没有的话先执行 corepack enable。

🎯 分场景玩法：调 REST、连 WebSocket、共享团队集合

调一个 REST 接口

选 REST 页签，填地址，挑方法，点发送。右侧立刻给出响应体和状态码。接口要密钥时，在认证面板挑 Bearer、Basic、OAuth 2.0 或 API Key，请求头会自动拼好。不想手填？把同事发的 curl 直接贴进地址栏，能自动转成请求。已有集合也不用重建，Postman 和 Insomnia 的导出文件可直接导入。导入导出逻辑在 packages/hoppscotch-common/src/helpers/import-export/。

写一个 GraphQL 查询

切到 GraphQL 页签，填端点地址，编辑器里写查询语句。变量放变量面板，请求头放 Headers 面板。点发送，返回的 JSON 会自动格式化展示。端点填好后还能自动拉取 schema，能用的字段和类型一目了然。

连上 WebSocket / MQTT

选 WS 页签，填 ws:// 或 wss:// 地址，点连接。收到的消息会在下方实时滚动，用输入框发消息可以验证服务端回包。MQTT 同理：选 MQTT 页签，填 broker 地址，订阅 topic，就能看到消息流。

团队共享同一份集合

团队功能跑在自建实例上。登录后建队，把成员拉进来，集合和环境变更实时同步给所有人。建议把开发、测试、生产三套环境分开建，避免误连生产地址。团队后端逻辑在 packages/hoppscotch-backend/src/team/。

🩹 报错速查：依赖装失败、端口被占用这样改

• pnpm install 中途挂掉 → 执行 pnpm store prune 清缓存，再重新 pnpm install。
• 端口被占用、地址打不开 → lsof -i :4173 看谁占着，或 export PORT=4174 换个端口。
• 构建时内存吃紧、OOM → 设置 NODE_OPTIONS=--max-old-space-size=8192 再启动。

✅ 收尾：谁该用它，接下来做什么

一个人调接口，或团队要共用一份集合，这套免费 API 测试工具都能直接用。接下来三件事：先把开发、测试、生产三套环境建好；再给常用接口配好认证；然后翻一遍仓库根目录的 README.md，看完整功能清单。

【免费下载链接】hoppscotchOpen-Source API Development Ecosystem • https://hoppscotch.io • Offline, On-Prem & Cloud • Web, Desktop & CLI • Open-Source Alternative to Postman, Insomnia项目地址: https://gitcode.com/GitHub_Trending/ho/hoppscotch