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 的开源替代品，能发 REST、GraphQL、WebSocket 等接口请求，Web、桌面端、CLI 都能跑，甚至能装成手机应用。适合需要测试接口的开发者，也适合想快速入门 API 调试的新手。
4 个亮点，值得上手用
- 🚀 免费开源：个人和公司都能用，不需要任何付费订阅
- 多协议一站：REST、GraphQL、WebSocket、MQTT 全都支持
- 📱 跨平台：Web、桌面端、CLI、手机 PWA 全覆盖
- 轻量快速：界面简洁，还自带团队协作和集合共享
准备工作：先装好这几个工具
系统要求不高，Windows 10/11、macOS 10.15+、Linux 都行，4GB 内存、500MB 空闲磁盘就够。真正要提前装好的只有两样：
| 工具 | 用途 |
|---|---|
| Node.js 16 以上（建议更新版本） | 运行前端项目的基础运行环境 |
| Git + pnpm | 拉代码、装依赖；pnpm 是强制的包管理器，不接受 npm |
pnpm 没装过的话，终端里敲一条 npm i -g pnpm 就行。
四步跑起 Web 版
- 把代码拉到本地并安装依赖：
git clone https://gitcode.com/GitHub_Trending/ho/hoppscotch cd hoppscotch && pnpm install- 在仓库根目录运行 pnpm dev，启动本地开发服务器，第一次编译稍慢，耐心等一下。
- 浏览器打开终端里打印的访问地址（一般是 http://localhost:3000），看到主界面就成功了。
- 装好的项目可以随意重启，数据存在浏览器本地，关掉不丢。
其他平台一句话带过：桌面端建议直接下载官方安装包，macOS 也可以走 brew install --cask hoppscotch；手机端用浏览器打开 Web 版后选「添加到主屏幕」，就是一个能离线用的 PWA 应用。
首次体验：发出你的第一个 GET 请求
打开主界面后，顶部地址栏输入一个能返回 JSON 的公开接口地址，方法默认就是 GET，点「发送」——右侧立刻出现响应状态码和返回内容，这就是 API 测试最核心的动作，整个过程不到 10 秒。
常用配置速览
- 环境变量：在「Environments」区建几组变量（开发/测试/生产），请求里用 {{变量名}} 引用，切换环境一键搞定，不用反复改地址。
- 认证：「Auth」标签页支持 Bearer Token、Basic Auth、OAuth 2.0、API Key，常用方式都在，照着填就能发带鉴权的请求。
- 集合导入导出：能把 Postman、Insomnia 的现有集合一键导入，也能把自己的集合导出成文件备份或分享给同事。
避坑指南：4 个高频问题这样解
⚠️npm install 直接报错？项目只允许用 pnpm 装依赖。先 npm i -g pnpm 装上 pnpm，再重新 pnpm install 即可。
依赖安装中途失败？清掉缓存重装：
pnpm store prune pnpm install提示 3000 端口被占用？用 lsof -i :3000 查出谁占着，关掉它，或者换个端口（比如 3001）启动。
构建很慢或内存吃紧？日常调试 Web 版就够了，桌面打包属于可选动作，真要打包时先关掉多余的浏览器标签页和大内存程序。
写在最后
到这里，你手上已经有一个能用的 Hoppscotch，随时可以开始测试自己的第一个接口。建议下一步把团队的 Postman 集合导进来，逐步建成自己的 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），仅供参考
