結果——

于是我第 N 次動了“換工具”的念頭。兩小時后,我把整套流程遷移到了 Hoppscotch——一款只有 3.2 MB、完全開源、支持 PWA 的 API 神器。
遷移成本:45 分鐘;團隊效率提升:肉眼可見。
如果你也受夠了 Postman 的“大而全、慢而卡”,這篇實戰筆記帶你手把手上車。


1. 認識 Hoppscotch:2025 年的新面孔

維度 Hoppscotch Postman
啟動方式 瀏覽器即開即用 https://hoppscotch.io 需安裝 300 MB 客戶端
開源協議 MIT,GitHub 70k? hoppscotch/hoppscotch 核心閉源
2025 新特性 AI 生成斷言、實時協作光標、本地優先加密同步
Mock 能力 云端 0 代碼,1 秒生成 Swagger/OpenAPI 示例 需自建 Mock Server
離線支持 PWA 離線寫請求 需付費離線模式

一句話:Hoppscotch = Postman 常用功能 90 % + Insomnia 顏值 + Apifox Mock 智能度 + 完全免費


2. 極速上手:3 分鐘完成第一個 REST 請求

Step 1 打開即玩

瀏覽器輸入 https://hoppscotch.io,無需注冊即可開始。

Step 2 創建請求

  1. 點擊左上角 “REST”
  2. 地址欄輸入:https://api.github.com/repos/hoppscotch/hoppscotch
  3. 選擇 GETSend
  4. 下方實時返回 JSON,耗時 113 ms(網絡面板同時展示 DNS、TLS、TTFB 等細節)。

Step 3 保存為集合

點擊右上角 “Save” → 新建集合 “Hoppscotch Demo” → 命名 “Get Repo Info”
集合自動同步到 IndexedDB,后續離線依舊可用。


3. Mock 服務全流程:零后端跑通前端

場景

前端妹子需要 /v1/products 列表,但后端排期下周。
傳統做法:在 Postman 里建 Mock Server → 寫死 5 條 JSON → 分享 url。
Hoppscotch 2025 做法:

3.1 一鍵生成 Mock

  1. 在集合里點擊 “Mock”“Generate from OpenAPI”
  2. 上傳或粘貼 Swagger YAML(支持 3.1 規范)
  3. 勾選 “Smart Mock”(2025 新功能,根據字段名自動返回 faker.commerce.productName() 等)
  4. 點擊 “Deploy” → 得到 https://mock.hoppscotch.io/team-id/xxx

3.2 實時預覽

前端直接 fetch("https://mock.hoppscotch.io/team-id/v1/products"),返回:

[
  {
    "id": 1,
    "name": "Rustic Rubber Pants",
    "price": 742.00,
    "image": "https://picsum.photos/seed/1/300/300"
  },
  ...
]

圖片隨機、價格區間、中文標題均支持配置。

3.3 動態規則


4. 高階玩法:環境變量 + 腳本 + CI

4.1 環境變量

點擊左側 “Environments” → 新建 “Dev / Stag / Prod”
示例變量:

baseURL = https://api.dev.internal
token = < jwt>
timeout = 5000

在 URL 中直接寫 {{baseURL}}/users,一鍵切換環境。

4.2 Pre-request & Test 腳本

Hoppscotch 使用 QuickJS 引擎,語法與 Postman 基本一致:

// Pre-request
pw.env.set("timestamp", Date.now());

// Test
pw.test("Status is 200", () => {
  pw.expect(pw.response.status).toBe(200);
});

2025 年新功能:

4.3 CI 集成

官方提供 @hoppscotch/cli,支持 GitHub Actions:

# .github/workflows/api-test.yml
- uses: hoppscotch/cli@v2
  with:
    file: 'hoppscotch-collection.json'
    env: 'prod'
    bail: true

執行結果直接上傳到 Checks 面板,失敗可下載 HTML 報告。


5. 團隊協作:權限、評論、變更記錄

功能 Hoppscotch Cloud 免費版 Postman 免費版
實時多人編輯 ? 光標可見 ?
評論 & @提醒 ? ?
變更 diff ? 逐行高亮 ?
權限粒度 集合級 Read / Write / Admin 工作區級
Guest 訪問 ? 免注冊只讀鏈接 ?

小技巧:把 “Share as Website” 生成的鏈接甩給產品,她就能在瀏覽器里直接調接口,不再裝任何客戶端。


6. 插件生態與二次開發

6.1 瀏覽器插件

6.2 本地部署

一條 Docker 命令擁有私有 Hoppscotch:

docker run -d -p 3000:3000 \
  -e ENABLE_SUBPATH_BASED_ROUTING=true \
  hoppscotch/hoppscotch:latest

自托管后,可接入企業 LDAP、審計日志、自定義主題。

6.3 二次開發

前端基于 Vue 3 + Vite + TypeScript,插件系統采用 WebExtension 標準。
示例:寫一個“一鍵翻譯錯誤碼”的插件只需 20 行代碼,官方模板


7. 與 Postman / Insomnia / Apifox 的硬核對比

維度 Hoppscotch Postman Insomnia Apifox
安裝包 0 MB 300 MB 90 MB 150 MB
啟動時間 < 1 s 6-8 s 2-3 s 3-4 s
Mock 智能生成 ? AI ? 手動 ? ?
實時協作 ? ? 付費 ? ? 付費
離線 PWA ? ? ? ?
CLI ? ? ? ?
企業 SSO ? 自建 ? 付費 ? ? 付費
學習曲線 ★☆☆ ★★☆ ★★☆ ★★★

結論:


8. 常見坑 & 2025 年路線圖

8.1 常見坑

  1. CORS 預檢失敗
    在 Mock 服務里加條響應頭:Access-Control-Allow-Methods: *
  2. 大文件上傳
    瀏覽器限制 2 GB,建議用 CLI 或分片。
  3. 離線沖突
    打開 “Local-first mode” 避免云端覆蓋。

8.2 2025 路線圖(官方社區投票)


9. 一鍵遷移腳本 & 資料下載

9.1 Postman → Hoppscotch

npx @hoppscotch/migrate \
  --from postman \
  --file Postman_collection.json \
  --output hoppscotch.json

自動轉換變量、腳本、文件夾層級,90 % 無需人工調整。

9.2 一鍵安裝(含 PWA)

<!-- 添加到主屏 -->
<link rel="manifest" href="https://hoppscotch.io/manifest.webmanifest">

9.3 資料匯總


結語:把省下來的 15 分鐘去喝咖啡

2025 年的開發節奏越來越快,工具鏈的“輕量化 + 智能化 + 零配置”才是未來。
Hoppscotch 用 70k star 的社區、3 MB 的體積和 0 美元的賬單告訴我們:
“讓 API 調試回歸簡單,剩下時間創造更有價值的東西。”

現在就在瀏覽器輸入 https://hoppscotch.io
把這篇指南甩給團隊,一起享受絲滑的 API 人生吧!

上一篇:

蘋果支付流程:從零開始的接入指南

下一篇:

香港支付寶可以綁定大陸銀行卡嗎?詳解使用方法與步驟
#你可能也喜歡這些API文章!

我們有何不同?

API服務商零注冊

多API并行試用

數據驅動選型,提升決策效率

查看全部API→
??

熱門場景實測,選對API

#AI文本生成大模型API

對比大模型API的內容創意新穎性、情感共鳴力、商業轉化潛力

25個渠道
一鍵對比試用API 限時免費

#AI深度推理大模型API

對比大模型API的邏輯推理準確性、分析深度、可視化建議合理性

10個渠道
一鍵對比試用API 限時免費