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