企业官网建设流程全解析

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

Hoppscotch 是一款免费开源的 API 测试工具，支持 REST、GraphQL、WebSocket 等协议，请求、认证、环境管理一应俱全。本指南按"先跑通、再部署、后提效"的顺序带你走完全流程，3 分钟内就能发出第一个请求。

🚀 3分钟发出第一个请求：零配置上手调试

不用装任何东西，浏览器打开就能用。在顶部请求栏选好方法（GET、POST 等），填上接口地址，就可以开始调试了：

1. 选择请求方法，填入目标 URL
2. 按需补上 Parameters、Body、Headers
3. 按下 Send，状态码、耗时、响应体立刻呈现

响应区支持一键复制 JSON、下载为文件，也能切到 Raw 和 Headers 视图。调试 echo 类接口时，发过去的参数是否完整，看回显就知道。

⚙️ 最快完成本地部署：3条命令启动自托管

公司有数据合规要求时，就得部署到自己的环境。仓库是 pnpm monorepo，装依赖、起服务只需要这几条命令：

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

Web 之外，还有两种形态可选：

• 桌面端（packages/hoppscotch-desktop）：Windows、macOS、Linux 原生体验，左上角实例切换器可随时在云后端与自建后端之间切换
• 命令行（packages/hoppscotch-cli）：适合 CI 流水线，批量跑集合里的用例

🔌 想测哪类接口就切哪个协议

不同类型的接口"性格"不同，Hoppscotch 把常用协议都收进了同一个工作区：

• REST：HTTP 方法全支持，还支持手输 LIST 之类的自定义方法
• GraphQL：配置好 endpoint 后自动拉取 schema，查询框带补全
• 实时类：WebSocket、Server-Sent Events、Socket.io，以及 MQTT 的订阅与发布
• 请求体支持键值对和 RAW 两种录入方式，JSON、FormData、XML 都能发

左侧协议列表点一下图标就切换对应标签页，不用在多个工具之间来回跳。

🔐 认证一次配置反复用：五种方式覆盖常见场景

Authorization 标签页内置了五种认证方式，基本够应对绝大多数接口：

• Basic：用户名加密码
• Bearer Token：直接粘贴令牌
• API Key：自定义头参数名和值
• OAuth 2.0：标准授权流程
• OIDC Access Token（PKCE）：面向单点登录场景

凭证填好之后保存在请求或集合里，后续请求直接复用。再配合环境变量，不同环境的 token 可以各存一份，切环境时不会串。

⚡ 环境变量 + 预请求脚本：两个提效利器

这是"发请求"和"做测试"的分水岭，用熟了效率差别很明显：

• 环境变量：dev、test、prod 三套配置各管各的，切环境等于整套变量一起换，请求本身不用动
• 预请求脚本：发送前执行一段 JavaScript，动态生成 token、时间戳、签名
• 断言测试：响应返回后自动校验状态码和字段值，不用肉眼比对

右侧 Variables 标签能看到当前环境实际替换了哪些变量，排查"为什么值不对"时很有用。

👥 团队协作：集合管理与共享

个人使用时，把请求按项目整理进集合，文件夹支持嵌套，还能一键导入导出。协作场景通常有两种走法：

1. 把集合导出成文件交给同事，或直接导入别人分享的集合
2. 部署一个实例，建团队工作区，成员对请求和环境的改动实时同步

请求历史会自动记录，上周调试过的请求翻历史记录就能找回来，省得重新搭参数。

📚 相关资源

• 官方文档：README.md
• 认证功能源码：packages/hoppscotch-common/src/components/accessTokens/
• 环境变量源码：packages/hoppscotch-common/src/newstore/environments.ts
• 桌面端入口：packages/hoppscotch-desktop/
• 自托管后端：packages/hoppscotch-backend/

免费、开源、多协议、可自托管，Hoppscotch 把 API 调试里最繁琐的环节都压到了最低。现在就可以从第一个 GET 请求开始，亲自感受一下轻量级调试的节奏。

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