三步上手 Hoppscotch API 测试从本地调试到团队 CI【免费下载链接】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接口联调时你大概也被这套动作拖慢过同一个接口开发、预发、生产三个环境的 Base URL 和 Token 各不相同每换一次环境就要手动重敲地址、重填请求头一个下午能浪费掉半小时。Hoppscotch 就是为这类场景准备的——它是一个开源的 API 开发生态可以理解为免费、自托管的 Postman/Insomnia 替代品支持 REST、GraphQL、WebSocket、MQTT 四类协议同一套代码覆盖 Web、桌面端和命令行。读完这篇你能拿到三样东西本地跑起来的一个请求、一套可一键切换的环境变量、一份能直接丢进 CI 流水线执行的集合文件。三步跑通本地环境仓库是个 pnpm monorepo前端、后端、管理面板、CLI 都在packages/下面你不需要读懂代码只要知道哪部分跑在哪就行。整条链路就三步git clone https://gitcode.com/GitHub_Trending/ho/hoppscotch cd hoppscotch cp .env.example .env pnpm install pnpm run generate pnpm dev先别急着删掉cp .env.example .env这步后端启动前需要DATABASE_URL、32 位的DATA_ENCRYPTION_KEY等配置模板文件里都有默认值直接复用最快。pnpm dev会在终端列出本地访问地址浏览器打开后随便找个熟悉的 GET 接口点发送看到 200 响应就算通了。如果你的机器不方便跑构建链还有个更省事的替代直接docker compose up -d仓库根目录的 compose 文件已经把数据库、后端、Web 都编排好了。本地调试用环境变量URL 从此不用重敲这是把 Hoppscotch 用顺手的关键一步。在主界面顶部找到Environments环境入口建 dev、staging、prod 三套环境每套里只放差异项比如hostdev.api.example.com请求的 URL 里写成{{host}}占位。为什么要绕这一道因为变量在发送前会被自动替换进 URL、Header 和 Body一套请求可以同时服务多套环境而且导出的集合文件里不含任何环境专属信息可以放心共享给同事不会把测试环境的地址泄露到生产集合里。Token 这类敏感值也建议放进环境变量而不是写死在请求里换 Key 时只改一处。验证方式很简单切到不同环境再发同一个请求地址自动变化、响应一致就算配好了。打开桌面端离线也能用的稳定调试台如果你常需要在没有浏览器标签页干扰的场景下调试可以试试桌面端基于 Tauri 的本地应用。它有两个好处一是本地不受浏览器跨域限制请求由本地服务发出省掉配置代理的麻烦二是可以直连你自己的自托管后端直接复用团队数据。cd packages/hoppscotch-desktop pnpm tauri dev第一次跑会编译 Rust 依赖稍慢属正常。桌面端代码都在 hoppscotch-desktop 下想改托盘、更新逻辑可以从src-tauri/入手。给团队自托管一套实例个人用浏览器版数据只存在本地想共享集合、实时同步、权限管控就必须自托管。后端是 NestJS Prisma PostgreSQL 的组合核心配置都在根目录.env里源码可以看 hoppscotch-backend 这个模块。真正要留神的是WHITELISTED_ORIGINS它声明哪些前端地址允许和后端跨域通信是后面几乎所有 CORS 报错的源头部署到新域名前先把新地址加进去。另外VITE_BACKEND_GQL_URL要指到你的后端 GraphQL 地址默认localhost:3170。配好后的验证路径访问 3000 端口的 Web 端注册账号再到 3100 端口的管理后台建团队、拉同事进来两边能实时看到彼此对集合的修改就算打通了。把集合丢进 CI用 hopp CLI 跑 API 测试Hoppscotch 的集合本质是一个 JSON 文件UI 里随时可以导出。CLIhopp命令能原样执行它包括每个请求的预执行脚本和测试脚本hopp test collection.json -e env.json --reporter-junit report.xml这一步的价值在于把人工点一遍接口变成每次合并自动跑一遍report.xml的 JUnit 报告可以无缝接进任何 CI 系统。env.json就是普通的键值对脚本里用pw.env.get(ENV1)读取环境差异同样不用改集合本身。更多参数迭代数据、延迟、访问令牌可以看 hoppscotch-cli 模块的 README。最常见的三个报错怎么解npm install直接报错退出仓库preinstall强制只允许 pnpm 安装。解法npm i -g pnpm pnpm install。pnpm dev后后端起不来、日志提示数据库连不上.env里DATABASE_URL指向的 PostgreSQL 根本没运行。解法先docker compose up -d把数据库拉起来再重新pnpm dev。登录后数据不同步、控制台一片 CORS 红字你部署的前端源地址不在WHITELISTED_ORIGINS白名单里。解法把完整源含端口追加进.env的该变量重新构建前端。先把你的集合导出成 JSON用上面那条hopp test命令在流水线里跑通它——这是从用到用顺手最短的一步。想进一步玩脚本沙箱和测试断言可以翻翻 hoppscotch-js-sandbox 里的实现。【免费下载链接】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），仅供参考
三步上手 Hoppscotch API 测试：从本地调试到团队 CI
三步上手 Hoppscotch API 测试从本地调试到团队 CI【免费下载链接】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接口联调时你大概也被这套动作拖慢过同一个接口开发、预发、生产三个环境的 Base URL 和 Token 各不相同每换一次环境就要手动重敲地址、重填请求头一个下午能浪费掉半小时。Hoppscotch 就是为这类场景准备的——它是一个开源的 API 开发生态可以理解为免费、自托管的 Postman/Insomnia 替代品支持 REST、GraphQL、WebSocket、MQTT 四类协议同一套代码覆盖 Web、桌面端和命令行。读完这篇你能拿到三样东西本地跑起来的一个请求、一套可一键切换的环境变量、一份能直接丢进 CI 流水线执行的集合文件。三步跑通本地环境仓库是个 pnpm monorepo前端、后端、管理面板、CLI 都在packages/下面你不需要读懂代码只要知道哪部分跑在哪就行。整条链路就三步git clone https://gitcode.com/GitHub_Trending/ho/hoppscotch cd hoppscotch cp .env.example .env pnpm install pnpm run generate pnpm dev先别急着删掉cp .env.example .env这步后端启动前需要DATABASE_URL、32 位的DATA_ENCRYPTION_KEY等配置模板文件里都有默认值直接复用最快。pnpm dev会在终端列出本地访问地址浏览器打开后随便找个熟悉的 GET 接口点发送看到 200 响应就算通了。如果你的机器不方便跑构建链还有个更省事的替代直接docker compose up -d仓库根目录的 compose 文件已经把数据库、后端、Web 都编排好了。本地调试用环境变量URL 从此不用重敲这是把 Hoppscotch 用顺手的关键一步。在主界面顶部找到Environments环境入口建 dev、staging、prod 三套环境每套里只放差异项比如hostdev.api.example.com请求的 URL 里写成{{host}}占位。为什么要绕这一道因为变量在发送前会被自动替换进 URL、Header 和 Body一套请求可以同时服务多套环境而且导出的集合文件里不含任何环境专属信息可以放心共享给同事不会把测试环境的地址泄露到生产集合里。Token 这类敏感值也建议放进环境变量而不是写死在请求里换 Key 时只改一处。验证方式很简单切到不同环境再发同一个请求地址自动变化、响应一致就算配好了。打开桌面端离线也能用的稳定调试台如果你常需要在没有浏览器标签页干扰的场景下调试可以试试桌面端基于 Tauri 的本地应用。它有两个好处一是本地不受浏览器跨域限制请求由本地服务发出省掉配置代理的麻烦二是可以直连你自己的自托管后端直接复用团队数据。cd packages/hoppscotch-desktop pnpm tauri dev第一次跑会编译 Rust 依赖稍慢属正常。桌面端代码都在 hoppscotch-desktop 下想改托盘、更新逻辑可以从src-tauri/入手。给团队自托管一套实例个人用浏览器版数据只存在本地想共享集合、实时同步、权限管控就必须自托管。后端是 NestJS Prisma PostgreSQL 的组合核心配置都在根目录.env里源码可以看 hoppscotch-backend 这个模块。真正要留神的是WHITELISTED_ORIGINS它声明哪些前端地址允许和后端跨域通信是后面几乎所有 CORS 报错的源头部署到新域名前先把新地址加进去。另外VITE_BACKEND_GQL_URL要指到你的后端 GraphQL 地址默认localhost:3170。配好后的验证路径访问 3000 端口的 Web 端注册账号再到 3100 端口的管理后台建团队、拉同事进来两边能实时看到彼此对集合的修改就算打通了。把集合丢进 CI用 hopp CLI 跑 API 测试Hoppscotch 的集合本质是一个 JSON 文件UI 里随时可以导出。CLIhopp命令能原样执行它包括每个请求的预执行脚本和测试脚本hopp test collection.json -e env.json --reporter-junit report.xml这一步的价值在于把人工点一遍接口变成每次合并自动跑一遍report.xml的 JUnit 报告可以无缝接进任何 CI 系统。env.json就是普通的键值对脚本里用pw.env.get(ENV1)读取环境差异同样不用改集合本身。更多参数迭代数据、延迟、访问令牌可以看 hoppscotch-cli 模块的 README。最常见的三个报错怎么解npm install直接报错退出仓库preinstall强制只允许 pnpm 安装。解法npm i -g pnpm pnpm install。pnpm dev后后端起不来、日志提示数据库连不上.env里DATABASE_URL指向的 PostgreSQL 根本没运行。解法先docker compose up -d把数据库拉起来再重新pnpm dev。登录后数据不同步、控制台一片 CORS 红字你部署的前端源地址不在WHITELISTED_ORIGINS白名单里。解法把完整源含端口追加进.env的该变量重新构建前端。先把你的集合导出成 JSON用上面那条hopp test命令在流水线里跑通它——这是从用到用顺手最短的一步。想进一步玩脚本沙箱和测试断言可以翻翻 hoppscotch-js-sandbox 里的实现。【免费下载链接】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），仅供参考
![[光学原理与应用-521]：对光的错误理解与纠偏](http://pic.xiahunao.cn/yaotu/[光学原理与应用-521]：对光的错误理解与纠偏)
