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