Hoppscotch API 测试工具 3 分钟上手：从克隆到发出第一个请求-创锋一号

Hoppscotch API 测试工具 3 分钟上手：从克隆到发出第一个请求

【免费下载链接】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

正在调试接口、又想要一个可安装、离线可用的开源 API 测试工具的话，Hoppscotch 值得部署到本机：它支持发送 HTTP/HTTPS 请求、调试 GraphQL 与 WebSocket 连接，还能把接口整理成集合，全部在一个界面里完成。如果你是前端、后端开发或测试同学，准备在自己的机器上装一套 API 调试工具，这篇内容适合你。按下面的节奏走，3 分钟后服务就能跑起来并发出第一个请求。

🔧 确认安装依赖清单

开始之前，对照下面这份清单检查本地环境，缺什么先补什么：

Node.js 18.0 及以上版本（monorepo 构建工具链依赖它）
pnpm 10.x 包管理器（项目强制要求使用它）
Git 用于拉取代码
4GB 以上可用内存
2GB 以上可用磁盘空间

清单很短，确认完这几项就可以开始配置了。

🚀 完成本地部署的三步操作

第一步：克隆项目代码

把仓库拉到本地，并进入项目根目录：

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

预期：终端显示下载进度，结束后当前目录出现 packages 子目录，里面是 hoppscotch-common、hoppscotch-backend 等多个子模块，其中 hoppscotch-common 是你之后用得最多的 Web 界面主体。

第二步：安装全部依赖

一条命令装完所有子模块的依赖：

pnpm install

预期：终端持续输出安装进度，最后没有出现红色报错信息，即可进入下一步。

第三步：启动开发服务

启动 Web 开发服务，浏览器直接指向它：

pnpm dev

预期：终端打印本地访问地址，用浏览器打开终端显示的 localhost 地址，能看到 Hoppscotch 的主界面，左侧是集合列表，右侧是请求面板。这个服务带热重载，之后改动代码会自动生效。

⚡ 快速上手：发出第一个 API 请求

顶部请求栏保持默认 GET 方法，在 URL 输入框填入测试地址https://httpbin.org/get，点 Send 按钮，下方会依次出现状态 200、响应耗时和完整响应内容，看到它们就说明通了
要改请求参数，点 URL 栏右侧的 Body 或 Headers 标签页；表单上传场景把请求体类型选成 multipart/form-data；响应是 JSON 时下方默认按语法高亮展示，也能切到 Raw 或 Headers 视图
点请求上方的 Save 按钮并命名，请求就存进左侧集合里，下次从列表点开重发即可，也可以在集合顶部的搜索框里按名称查找

📌 常见卡点速查

pnpm 命令找不到：项目强制用 pnpm，先执行npm install -g pnpm全局装好再回来继续
启动时终端提示的是别的端口：服务没挂，只是挪到了终端打印的可用端口，直接打开那个地址
pnpm install 卡住或失败：删掉 node_modules 目录后重跑pnpm install，网络不稳时可以先给 pnpm 配置镜像源

🧭 接下来可以探索

用环境变量保存不同环境的接口地址和令牌，请求会自动按选中的环境替换，切换环境就在页面右上角进行
顶部标签页切到 GraphQL、WebSocket 或 MQTT，同一个面板测试其他通信协议
团队有自建后端的话，把 packages 下的 hoppscotch-backend 子模块接上，解锁团队共享集合等协作能力

到这里就搞定了，现在就去浏览器里把第一个请求发出去。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

企业官网建设流程全解析