3 步装好 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 测试工具，作为 Postman 与 Insomnia 的免费替代方案，覆盖 Web、桌面与 CLI 三种形态。这篇教程带你用 3 条命令完成安装并跑通第一个请求，适合需要快速调试接口的前端、后端与测试同学。
为什么选择 Hoppscotch
它解决的核心问题，可以概括为三点：
- 免费开源：无需购买许可，也无需注册账号即可开始调试接口，省去商业工具的成本和账号流程。
- 协议覆盖广：HTTP/HTTPS、WebSocket、GraphQL 三类常用协议在同一界面完成测试，减少工具间切换。
- 形态灵活：Web 端、桌面端、CLI 均可使用，离线场景也能运行。
🚀 最小安装路径：3 条命令跑通
打开终端，按顺序执行以下命令：
- 克隆源码并进入目录
git clone https://gitcode.com/GitHub_Trending/ho/hoppscotch cd hoppscotch本地出现 hoppscotch 文件夹，且目录下能看到 package.json，说明克隆成功。
- 安装依赖
pnpm install输出中没有 error，依赖全部下载完成即成功（约需 3~5 分钟）。
- 启动开发服务器
pnpm dev终端输出本地地址后，浏览器访问 http://localhost:3000 ，看到请求编辑界面即代表跑通。
环境与依赖速查表
安装前先对照这张表确认本机条件：
| 依赖项 | 最低要求 |
|---|---|
| Node.js | 14.0 及以上 |
| 包管理器 | pnpm（npm 或 yarn 亦可） |
| Git | 用于克隆源码 |
| 内存 | 至少 4GB |
| 磁盘空间 | 至少 1GB 可用空间 |
| 操作系统 | Windows 10/11、macOS 10.15+ 或 Ubuntu 18.04+ |
可选依赖：Tauri 开发环境，仅在运行pnpm desktop:dev构建桌面应用时需要。
验证安装并发送第一个 API 请求
先确认三件事：浏览器能打开 http://localhost:3000 、页面正常显示 URL 输入框和方法选择器、终端无持续报错。
然后完成第一个最小操作：
- 在 URL 输入框中填入测试地址
- 选择 HTTP 方法（GET、POST、PUT 等）
- 点击发送按钮，查看响应结果
响应面板返回状态码与响应体，说明整条链路已跑通。之后可以用 Collections 组织相关接口，用 Environments 管理不同环境的变量，用 History 回看历史请求。
🔧 常见坑排错
按现象对照处理：
- 3000 端口被占用→ 启动时会自动改用其他可用端口，以终端最新输出为准。
- pnpm install 失败→ 删除 node_modules 与 pnpm-lock.yaml，重新执行
pnpm install。 - 安装全局依赖提示权限不足→ 在 Linux 或 macOS 上改用 sudo 执行。
功能全景与进阶配置
已覆盖的核心功能：
- HTTP/HTTPS 请求
- WebSocket 实时通信测试
- GraphQL 查询调试
- 环境变量管理
- 团队协作
- 离线使用
进阶配置（按需开启）：
- 自定义主题与界面布局
- 设置代理服务器
- 配置认证方式
- 集成 CI/CD 流程
生产构建与桌面模式
生产构建，生成可部署的静态文件：
pnpm build构建完成后会生成优化过的静态资源，可直接部署到服务器。
桌面应用开发模式，基于 Tauri 框架构建原生应用：
pnpm desktop:dev桌面窗口正常打开即成功。
项目全貌可参考根目录的 README.md 与 CONTRIBUTING.md，前端核心源码位于 packages/hoppscotch-common/ 目录。到这里，你的 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
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
