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 可以直接顶上REST、GraphQL、WebSocket/MQTT 全支持还能以 Web、桌面、CLI 三种形态运行。照着本文走一遍你半天内就能在本地跑起 Hoppscotch 网页版完成发请求、配环境和排查常见故障这三件事。先判断3 类角色用 Hoppscotch 最合适这一节帮你花 1 分钟确认它值不值得装。️前后端开发联调阶段直接粘贴 cURL 重放无需手工重建请求测试工程师请求支持前置脚本和后置断言集合可导入导出、团队复用☁️自托管/运维MIT 协议可整套部署在内网请求数据不出本机小团队协作配好后端后可建团队集合、按角色分配权限并云端同步如果你只是偶尔看看静态网页、不需要管理请求那它对你意义不大。安装前核对 4 项系统条件这一节避免你在安装中途卡在环境问题上。项目要求操作系统Windows 10/11、macOS 10.15、Ubuntu 18.04内存 / 磁盘4GB RAM、500MB 以上空闲空间Node.js16 以上建议用 LTS包管理器只能用 pnpm根目录 preinstall 会直接拦截 npm/yarn4 步在本地跑起 Hoppscotch 网页版这一节解决第一次怎么把它打开。克隆仓库并进入目录用 pnpm 安装依赖monorepo一次装齐所有子包启动开发服务浏览器打开http://localhost:3000git clone https://gitcode.com/GitHub_Trending/ho/hoppscotch cd hoppscotch pnpm installpnpm dev开发模式起的是 selfhost-web 的 Vite 服务。想要更接近线上的产物先执行pnpm generate构建全部子包再用pnpm start以静态方式托管。想体验桌面端则进入packages/hoppscotch-desktop执行pnpm tauri dev需要 Rust 工具链它基于 Tauri 打包数据默认留在本地。按场景配置请求REST、GraphQL 与实时协议这一节解决打开之后不同协议的接口分别在哪配、怎么配。发一个 REST 请求并验证响应做什么发出请求并核对状态码、头、正文在哪配默认主页顶部怎么配选方法 → 填 URL → 点 Send。需要鉴权时在 Auth 面板选 Basic、Bearer、OAuth 2.0 或 API KeyBody 面板设置 Content-Type 后填键值对或原始文本动态逻辑写进 Pre-Request 脚本断言写进 Tests如校验状态码、解析响应取字段。拉取 schema 再写 GraphQL 查询做什么对接 GraphQL 端点在哪配顶部协议下拉切到 GraphQL怎么配填入端点地址后自动拉取 schema右侧多栏文档可以直接浏览字段左边写好查询发送即可。相关解析逻辑见 packages/hoppscotch-common/src/helpers/graphql/。订阅 WebSocket 与 MQTT 主题做什么全双工通信、服务端事件、消息订阅在哪配顶部协议下拉里的 WebSocket、Socket.IO、SSE、MQTT 页签怎么配填入 ws:// 地址连接后直接收发MQTT 填 broker 地址与 topic 即可订阅发布。协议封装源码见 packages/hoppscotch-common/src/helpers/realtime/。用环境变量在开发/测试/生产之间一键切换这一节解决同一套请求多个环境地址不一样每次手改很烦的问题。左侧 Environments 面板新建多套环境dev / test / prod各自存放变量URL、Header 里用{{base_url}}、{{token}}引用请求体一处写死、处处复用顶部切换当前环境后重发即可请求本身一个字不用动前置脚本能动态写变量例如把登录响应的 token 解析后存回环境后续请求自动带上自托管团队场景下桌面端可以指向你自己的实例团队环境与集合随之同步变量数据模型可以参考 packages/hoppscotch-data/src/environment/。排查 4 个最常见的启动与使用问题这一节按现象 → 原因 → 一句话解法给出对应关系遇到问题对号入座。现象原因解法安装时提示 only-allow pnpm根脚本强制 pnpm 工具链换用pnpm install不要用 npm/yarn3000 端口打不开selfhost-web 默认占用 3000 且被占用在 vite.config.ts 改 server.port浏览器发 API 被 CORS 拦截浏览器跨源限制在设置里启用 Proxy 模式走代理转发桌面端连不上自托管实例实例地址填错或后端未启动检查桌面端实例地址先用docker compose up把整套服务拉起来到这里你手上已经有一套本地可用的 Hoppscotch网页版跑在 3000 端口REST、GraphQL 和实时请求都会发多环境也能一键切换接下来要补登录同步和团队协作时再按自托管文档把后端服务补上即可。【免费下载链接】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），仅供参考