
完整指南幾分鐘內從源碼跑通 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/hoppscotchHoppscotch 是一套開源的 API 開發與測試工具定位是 Postman、Insomnia 的免費替代發 HTTP 請求、調 WebSocket、寫 GraphQL 查詢、管環境變量Web、桌面、CLI 三種形態都有。這篇文章不講功能清單只回答一件事——怎么把它在你自己的機器上跑起來三條命令起 Web 版、一條命令出生產構建、桌面版和 CI 集成各走哪條路。先選路線再動手同一個倉庫里有好幾個子項目先想清楚你要哪種形態能省掉一半時間Web 版最常用瀏覽器里調試 API日常開發首選路徑在packages/hoppscotch-common和packages/hoppscotch-selfhost-web自托管生產版給團隊建一個私有實例帶登錄和同步涉及packages/hoppscotch-backend桌面版基于 Tauri 的原生應用在packages/hoppscotch-desktopCI 集成用packages/hoppscotch-cli提供的hopp test命令跑自動化測試環境自檢先確認三樣東西跑之前檢查環境避免裝到一半報錯pnpm倉庫強制只用 pnpm根package.json里有preinstall鉤子用 npm 或 yarn 安裝會直接報錯項目鎖定的版本是 pnpm 10Node.js 22CLI 子項目明確要求 Node 22建議直接上 22約 1GB 磁盤 4GB 內存monorepo 依賴較多安裝和首次啟動都偏吃資源桌面版額外需要 Rust 工具鏈Linux 用戶還建議 Ubuntu 22.04 以上依賴 libwebkit2gtk-4.1官方推薦 24.04。三步跑起 Web 版git clone https://gitcode.com/GitHub_Trending/ho/hoppscotch cd hoppscotch pnpm install安裝過程會觸發工作區里每個子包的后置腳本比如 GraphQL 代碼生成耗時會比一般項目長屬正常現象。裝完啟動開發服務器pnpm dev這一條命令會通過pnpm -r do-dev同時拉起前端hoppscotch-common和自托管 Web 端hoppscotch-selfhost-web的 Vite 服務帶熱重載。等終端輸出ready后打開它打印的本地地址即可具體端口以終端為準Vite 默認一般落在 5173 一帶。發第一個請求頂部選 HTTP 方法 → URL 欄填接口地址 → 點 Send響應、頭部、狀態碼都會顯示在下方面板里。后續把常用請求存進 Collections用 Environments 管理不同環境的變量即可。打成生產版并自托管開發驗證沒問題后構建靜態產物pnpm generate再在根目錄用pnpm start起一個靜態服務基于 http-server默認 3000 端口做快速預覽。要真正給團隊用推薦走 Docker倉庫根目錄有docker-compose.yml一鍵拉起前端、后端packages/hoppscotch-backendNestJS Prisma PostgreSQL整套服務。一個容易踩的點桌面版要連接自托管實例時需要在.env的WHITELISTED_ORIGINS里加上app://形式的前端來源細節見packages/hoppscotch-desktop/README.md。桌面版Tauri 構建原生應用桌面版是跨平臺的 Tauri 應用除了 Rust 工具鏈外無特殊依賴。啟動開發模式cd packages/hoppscotch-desktop pnpm tauri dev正式版打包用pnpm tauri build即build:full腳本。它可以直接連官方云也可以通過添加實例連你自己的自托管地址。最低系統要求Windows 10 1803 / Windows 11 x64、macOS 10.15Intel 或 Apple Silicon、Linux x64 且 GLIBC 2.38。把測試搬進 CIhopp test不想只靠人點CLI 子包hoppscotch/cli入口命令hopp能把你在界面里寫好的測試腳本直接跑在流水線里npm install -g hoppscotch/cli hopp test collection.json -e env.jsoncollection.json是從 Hoppscotch 導出的集合文件env.json提供環境變量。常用選項還有--server指向自托管實例、--reporter-junit輸出 JUnit 報告方便接 CI 看板、--delay請求間隔。踩坑速查npm/yarn 裝不上報錯來自only-allow pnpm換 pnpm 重來依賴裝壞刪掉node_modules后重新pnpm install鎖文件pnpm-lock.yaml別刪它是可復現構建的保證端口被占開發服務器被別的進程占著時終端會換端口或報錯按終端輸出的實際地址訪問Linux 桌面版白屏/渲染異常Wayland 下 WebKit 與顯卡驅動的已知問題用WEBKIT_DISABLE_COMPOSITING_MODE1前綴啟動可繞過老系統報 GLIBC_2.32 not found桌面版 AppImage 要求 GLIBC 2.38升級系統或換新版發行版往哪走跑通之后代碼都擺在倉庫里界面邏輯看packages/hoppscotch-common/src/components后端 GraphQL 接口在packages/hoppscotch-backend/srcCLI 的測試執行邏輯在packages/hoppscotch-cli/src/utils。想改主題、加功能或 fork 一份私有部署從這幾個目錄入手最快。【免費下載鏈接】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),僅供參考