Hoppscotch 完整上手指南开源 API 测试工具从本地调试到团队共享 10 分钟跑通【免费下载链接】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团队接口一多你大概率经历过这种局面开发丢来一条 curl测试在别的工具里改了个 token联调时三方对不上号。Hoppscotch 是一个完全开源免费的 API 测试工具REST、GraphQL、WebSocket、MQTT 四类协议全支持既能开浏览器直接用也能自托管到内网、装进桌面端离线跑数据全程留在自己手里。这篇带你走最短路径——先跑通再谈协作和自动化。三步跑通本地调试环境 你不需要先理解它的内部结构。装好Node.js 22和pnpm仓库强制要求用 pnpm其他包管理器会被安装钩子拦下然后克隆代码并安装依赖git clone https://gitcode.com/GitHub_Trending/ho/hoppscotch cd hoppscotch pnpm install启动开发服务器浏览器打开http://localhost:3000即可进入完整界面pnpm dev主界面的布局一目了然左侧是集合树中间是请求编辑区右侧是响应与测试脚本结果。顶部选方法、填 URL点Send发请求右上角的环境切换器可以一键在开发、测试、生产三套变量间切换请求里写{{base_url}}这类占位符引用环境值——这是它防止环境串号的核心设计。把接口集合交给团队自托管一份 Hoppscotch 个人调试用浏览器版就够但当你想让整个团队共用同一套集合和环境就需要后端服务参与。项目自带 Docker Compose 编排内置 PostgreSQL 和自动迁移一条命令拉起全部服务docker compose --profile default up -d起来后访问3000端口是前端3170是后端 GraphQL API数据库占用5432。团队能力由 团队模块源码 所在的模块支撑按工作区和团队划分数据配合角色权限管理。已有自己的数据库时把 profile 换成default-no-db即可跳过内置 Postgres。部署完成后桌面端左上角的实例切换器能让你在云端版和私有部署之间自由切换快捷键和操作习惯完全一致离线和弱网场景桌面端与 PWA外网不稳、或者公司网络禁止访问云服务时桌面端基于 Tauri源码在packages/hoppscotch-desktop/可以直连你自托管的实例完全离线工作请求数据保存在本地不经过任何第三方移动端走 PWA 路线手机浏览器打开 Web 版在菜单里选添加到主屏幕就能获得带图标的近原生体验适合现场直接验证线上接口。把同一套测试接进 CI 流水线 最有意思的一点你在界面里写的请求和测试脚本导出的集合文件可以直接给 CI 用。官方 CLI 命令是hopp一条命令跑完整个集合并生成 JUnit 报告hopp test my-collection.json -e prod-env.json --reporter-junit配合--token参数还能直接读取自托管工作区里的集合与环境不必把 JSON 文件复制进代码仓库。测试脚本默认走沙箱执行遇到老脚本兼容性问题时加--legacy-sandbox回退即可。实战中绕不开的四个卡点依赖装不上确认 Node 版本不低于22且用的是 pnpm反复失败时先执行pnpm store prune清缓存再重装。端口被占用docker-compose.yml里的3000、3170、5432都是映射端口改宿主机侧的数值即可容器内部不用动。环境串号别在请求里写死域名一律走右上角环境切换器团队共用的环境保存在工作区而不是各存各的本地副本。CLI 批量跑挂默认沙箱是实验性的旧脚本建议--legacy-sandbox需要循环压测时用--iteration-data喂 CSV 文件做数据驱动测试。现在打开终端把第一条命令敲下去——克隆、装依赖、启动5 分钟后你就能在浏览器里发出第一个请求如果团队已经在用 Postman 或 Insomnia直接把现有集合导入当天就能共享同一套接口。【免费下载链接】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），仅供参考