企业官网建设流程全解析

Bruno 的 API 测试实操指南：本地集合从创建到 Git 协作一次跑通

【免费下载链接】brunoOpensource IDE For Exploring and Testing API's (lightweight alternative to Postman/Insomnia)项目地址: https://gitcode.com/GitHub_Trending/br/bruno

Bruno 是一个开源 API 客户端，定位是 Postman / Insomnia 的轻量替代：集合就是磁盘上的一个文件夹，请求存成纯文本，离线也能完整调试。下面从安装、搜索技巧讲到 Git 团队协作，带你十分钟把它跑起来。

它到底能做什么：Bruno 核心功能速览 ⚡

• 🔍 全局搜索跨集合定位接口，Cmd/Ctrl+K 直达
• 📁 集合就是普通文件夹，请求存成 .bru 纯文本
• ⚡ CLI 一条命令批量跑接口，直接接进 CI
• 🌐 支持导入 Postman、OpenAPI 等现有格式

适合接口多、要频繁切换环境、又介意数据上云的你。相比 Postman 的云端同步，Bruno 走的是纯本地加文本存储路线，是典型的本地 API 测试工具，断网照样用。

从零跑起来：Bruno 安装与首次配置

安装：Mac 用户用 Homebrew，Windows 用 Chocolatey，Linux 用 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 调试效率的操作技巧 🔍

用全局搜索定位跨集合的接口

接口散在多个集合里，翻文件夹找"登录"要翻半天。

1. 按 Cmd+K（mac）或 Ctrl+K（Windows）唤起全局搜索；
2. 输入关键词，比如 login；
3. 点结果直接打开请求。

关键词直接命中请求名，省掉逐层展开文件夹的步骤，找接口从翻几分钟变成两秒。

用侧边栏搜索过滤当前集合

单个集合几百个请求，目录树长得看不见头。

1. 点侧边栏顶部的搜索框；
2. 输入接口名或 URL 片段；
3. 树立刻收敛到命中分支，点开即用。

匹配是本地即时反馈，请求名里带中文也没问题。

用 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 可以参考着上手。

问：按 Cmd+K 全局搜索为什么搜不到？

答：全局搜索只覆盖已打开的集合，先确认目标集合在工作区里是打开状态。还是没结果就把关键词改短，搜索匹配的是请求名，长句子很容易漏掉。

问：几百个请求的集合，树加载有点卡怎么办？

答：侧边栏树是扫目录渲染的，按业务域拆成子目录，别把上千个文件平铺在根下。平时找接口别滚动翻树，直接用侧边栏搜索框过滤。

接下来往哪走：文档与贡献入口

• 中文版 README，先看它上手
• 贡献指南，含测试怎么跑
• Bruno CLI 完整命令参考
• Bru 文件格式规范

Bruno 的定位很明确：把 API 客户端放回本地文件系统。拉下来试十分钟，你会知道它适不适合你的工作流。

【免费下载链接】brunoOpensource IDE For Exploring and Testing API's (lightweight alternative to Postman/Insomnia)项目地址: https://gitcode.com/GitHub_Trending/br/bruno