Bruno 的 API 测试实操指南:本地集合从创建到 Git 协作一次跑通 📅 发布时间:2026/8/31 8:57:22 👁 浏览次数: Bruno 的 API 测试实操指南本地集合从创建到 Git 协作一次跑通【免费下载链接】brunoOpensource IDE For Exploring and Testing APIs (lightweight alternative to Postman/Insomnia)项目地址: https://gitcode.com/GitHub_Trending/br/brunoBruno 是一个开源 API 客户端定位是 Postman / Insomnia 的轻量替代集合就是磁盘上的一个文件夹请求存成纯文本离线也能完整调试。下面从安装、搜索技巧讲到 Git 团队协作带你十分钟把它跑起来。它到底能做什么Bruno 核心功能速览 ⚡ 全局搜索跨集合定位接口Cmd/CtrlK 直达 集合就是普通文件夹请求存成 .bru 纯文本⚡ CLI 一条命令批量跑接口直接接进 CI 支持导入 Postman、OpenAPI 等现有格式适合接口多、要频繁切换环境、又介意数据上云的你。相比 Postman 的云端同步Bruno 走的是纯本地加文本存储路线是典型的本地 API 测试工具断网照样用。从零跑起来Bruno 安装与首次配置安装Mac 用户用 HomebrewWindows 用 ChocolateyLinux 用 Snap一条命令搞定想折腾源码的开发者走下面的克隆路线。brew install bruno # Mac 上通过 Homebrew 安装 git clone https://gitcode.com/GitHub_Trending/br/bruno cd bruno npm install --legacy-peer-deps npm run setup npm run dev # 源码路线构建依赖并启动启动装完从开始菜单或 Dock 打开 Bruno源码路线跑npm run dev后会弹出应用窗口首次看到的是工作区页面。打开第一个集合点 Open Collection选磁盘上任何带 .bru 文件的文件夹左侧立刻出现请求树。发一个请求双击某个 .bru 打开编辑页在environments/目录里配好域名变量点 Send右侧响应面板直接出 JSON。三个提升 API 调试效率的操作技巧 用全局搜索定位跨集合的接口接口散在多个集合里翻文件夹找登录要翻半天。按 CmdKmac或 CtrlKWindows唤起全局搜索输入关键词比如 login点结果直接打开请求。关键词直接命中请求名省掉逐层展开文件夹的步骤找接口从翻几分钟变成两秒。用侧边栏搜索过滤当前集合单个集合几百个请求目录树长得看不见头。点侧边栏顶部的搜索框输入接口名或 URL 片段树立刻收敛到命中分支点开即用。匹配是本地即时反馈请求名里带中文也没问题。用 Bruno CLI 把集合跑进 CI接口改了之后回归还靠手动一个个点。npm install -g usebruno/cli # 安装 Bruno CLI bru run # 跑整个集合 bru run 用户中心 --env Local # 按目录和环境跑同一份集合界面里能点流水线里也能批量回归CLI 的退出码直接反映通过与否在 CI 里加一行就能拦住坏接口。把集合组织得像个人目录结构与 Git 协作 核心理念就一句话文件即接口。每个请求是一个 .bru 文本文件文件夹层级就是集合结构整个项目原样推成 Git 仓库就能协作diff 也读得懂。my-api/ ├── bruno.json ├── environments/ │ └── Local.yml └── 用户中心/ └── 认证/ └── 登录.bru建议给每个业务模块开独立分支合并时让队友在 PR 里看 .bru 的文本 diff加减一目了然。CI 里挂一条bru run做合并前回归接口坏了当场报警。敏感值比如 token 放environments/下的 .yml 里再配合 gitignore 把本地环境挡在仓库外。API 测试中的常见卡点与绕过方法问集合、文件夹、请求名能全用中文吗答能。集合就是磁盘上的文件.bru 文件名和目录名带中文完全没问题。注意应用界面目前只有英文——packages/bruno-app/src/i18n/下的翻译资源只含 en.json文档目录倒是有中文版 readme 可以参考着上手。问按 CmdK 全局搜索为什么搜不到答全局搜索只覆盖已打开的集合先确认目标集合在工作区里是打开状态。还是没结果就把关键词改短搜索匹配的是请求名长句子很容易漏掉。问几百个请求的集合树加载有点卡怎么办答侧边栏树是扫目录渲染的按业务域拆成子目录别把上千个文件平铺在根下。平时找接口别滚动翻树直接用侧边栏搜索框过滤。接下来往哪走文档与贡献入口中文版 README先看它上手贡献指南含测试怎么跑Bruno CLI 完整命令参考Bru 文件格式规范Bruno 的定位很明确把 API 客户端放回本地文件系统。拉下来试十分钟你会知道它适不适合你的工作流。【免费下载链接】brunoOpensource IDE For Exploring and Testing APIs (lightweight alternative to Postman/Insomnia)项目地址: https://gitcode.com/GitHub_Trending/br/bruno创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考