企业官网建设流程全解析

10 分钟跑通开源 API 测试工具 Hoppscotch：从克隆到发出第一个请求

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

还在浏览器里手工拼请求头、复制粘贴 Token？Hoppscotch 是一款免费开源的 API 测试工具，REST 与 GraphQL 都能测，从发请求到团队协作调试一站搞定。

它是什么，适合谁

Hoppscotch 是一个开源 API 开发生态：一个 Web 应用，外加桌面端和 CLI，定位是 Postman、Insomnia 的开源替代。除了 HTTP 请求，它还内置 GraphQL、WebSocket、MQTT、Socket.IO 等协议调试，既能装在自己电脑上用，也能私有化部署给整个团队共享。适合个人开发者、前后端工程师，以及需要在内网或离线环境使用 API 测试工具的小团队。

开跑前的 3 项检查

• Node 22 以上
• 安装 pnpm
• 磁盘留 500MB

前两项不是建议而是硬要求：仓库的 CLI 包和脚本沙箱包在 package.json 里声明了node >= 22，根目录的 preinstall 脚本则强制只允许用 pnpm 安装（它是 pnpm 多包工作区）。

10 分钟发出第一个请求

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

依赖装完、pnpm dev跑起来后，浏览器访问终端输出的本地地址，建一个集合、输入 URL、点发送，第一个请求就发出去了。

其他端不用额外折腾：桌面端在packages/hoppscotch-desktop目录里执行pnpm tauri dev即可（需装 Rust 工具链）；要给团队部署，仓库自带docker-compose.yml，一条命令拉起全部服务：

docker compose --profile default up

上手之后能做什么

把 Postman 老集合一键搬进来

Hoppscotch 的导入器支持 Postman、Insomnia、OpenAPI、HAR 文件，甚至直接粘贴 cURL 命令。把旧工具导出的 JSON 拖进导入弹窗，确认后集合结构、文件夹、认证配置都会带过来。迁移成本接近零，团队不用换工作流。

一套请求在开发、测试、生产间切换

把域名、密钥写成环境变量，请求里用{{baseUrl}}这类占位符引用，发送前在顶部切换环境即可。同一份集合就能打到不同后端，不用手工改 URL，也不怕误连生产库。

团队共用集合，实时协作

登录并创建团队后，把集合放进团队空间，成员的改动会实时同步（后端实现见packages/hoppscotch-backend/src/team）。还能把单个请求发布成分享链接，对方不用注册账号就能查看和调试。

加断言，跑成回归测试

请求支持前置脚本和测试断言，脚本在隔离沙箱中执行；集合保存后可批量运行并查看结果报告。同一套脚本还能通过仓库里的@hoppscotch/cli包在 CI 环境里跑，接口一变更当天就能发现，而不是上线后被用户抓到。

高频坑与解法

依赖安装失败。现象是pnpm install报网络错误或依赖损坏；原因多为本地缓存损坏。先执行pnpm store prune清理存储，再重新安装即可。

自部署时 3000 端口被占用。docker-compose 默认把应用映射到 3000 端口，已有其他服务占用时页面打不开。用lsof -i :3000找到占用进程，或直接修改docker-compose.yml里的端口映射避开冲突。

桌面端启动报找不到 cargo。桌面端是 Tauri 项目，依赖 Rust 工具链而不是只有 Node。按packages/hoppscotch-desktop目录的说明装好 Rust 后再执行pnpm tauri dev。

Hoppscotch 把请求调试、集合管理、团队协作装进一个免费开源的 Web 应用，私有化部署也没有门槛。下一步建议从仓库根目录的 README 看起，再翻一翻packages/hoppscotch-common/src/helpers/import-export里的导入器源码——看看 Postman 集合是怎么被解析的，比读十篇介绍更快建立对它的信心。

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