Hoppscotch 安装指南:5 分钟本地跑通开源 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 开发与调试工具,帮你快速发请求、看响应、管环境变量,不用注册账号,本地装完即用。读完这篇教程,你能完成 Hoppscotch 安装并发出第一个真实的 API 请求。
🧭 先看看它能干什么
一个界面里覆盖 HTTP、GraphQL、WebSocket、Socket.IO、MQTT 多种协议;请求的 Header、参数、Body 都有可视化编辑,还支持环境变量、请求集合、请求前脚本和请求后断言,响应面板可预览 JSON、HTML、XML,也能一键生成 10 多种语言的请求代码片段。
⚡ 3 步装好:克隆、装依赖、启动
环境只有一行要求:Node.js 18+ 和 pnpm(项目锁定 pnpm 10.x,用corepack enable即可启用)。
第一步,克隆项目到本地并进入目录:
git clone https://gitcode.com/GitHub_Trending/ho/hoppscotch cd hoppscotch看到本地出现 hoppscotch 目录、且里面包含 packages 文件夹,说明代码拿全了。
第二步,安装全部依赖:
pnpm install过程约 3-5 分钟,看到 Done 且无红色报错即成功。
第三步,启动开发服务:
pnpm dev终端出现 Vite 启动信息后,打开浏览器访问 http://localhost:3000 ,看到 Hoppscotch 主界面就算跑通了。
🎯 发出你的第一个请求
- 主页中间的请求栏里,左侧方法保持默认的 GET。
- 在右侧 URL 输入框粘贴一个公开测试地址,比如 https://jsonplaceholder.typicode.com/todos/1 。
- 点击 Send(或按 Ctrl+Enter)。
下方响应面板立刻返回状态码 200、响应体 JSON 和耗时。换一下方法、加点 Header 或 Body,响应会随你的改动实时更新——这就是 Hoppscotch 的日常用法。
🛠️ 三种运行模式,按需选择
| 模式 | 定位 | 命令 |
|---|---|---|
| 开发模式 | 热重载,日常体验与前端开发 | 根目录执行pnpm dev |
| 生产构建 | 生成可部署的静态文件 | 进入 packages/hoppscotch-selfhost-web 执行pnpm build |
| 桌面应用 | 原生窗口,可连接自托管服务 | 进入 packages/hoppscotch-desktop 执行pnpm tauri dev(需先装好 Rust) |
🔧 装不上、起不来?对照这张表
| 症状 | 原因 | 处理 |
|---|---|---|
| 安装时报 "Only pnpm is allowed" | 项目禁止 npm/yarn | 改用 pnpm 重新执行安装 |
| 安装中途网络中断、依赖损坏 | 网络不稳定 | 删除 node_modules,再跑一次pnpm install |
| 3000 端口被占用,打不开页面 | 端口冲突 | 看终端输出的实际端口,改访问那个端口 |
| 启动桌面应用报缺工具链 | 未安装 Rust/Tauri 依赖 | 先安装 Rust 工具链,再执行pnpm tauri dev |
🚀 再进一步
需要团队共享、登录同步和云端协作时,可以用 Docker 一起拉起后端与前端,编排文件见 docker-compose.yml;命令行党还可以用仓库里的 hoppscotch-cli 包把集合导入终端跑测试。
打开终端,敲下第一条 clone 命令,5 分钟后你就能在浏览器里发出第一个请求。Hoppscotch 采用 MIT 协议开源,完全免费,也可按自己的需求自由修改和定制。
【免费下载链接】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
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考