Bruno 三步上手 API 测试：本地集合、中文文档与高效搜索实战指南

Bruno 三步上手 API 测试：本地集合、中文文档与高效搜索实战指南

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

如果你想在本地文件夹里管理 API 请求，并用一个轻量级工具完成探索、测试和团队协作，Bruno 值得认真看一眼。它是开源的 API 探索与测试 IDE，请求以纯文本文件存储，天然适合 Git 版本控制；配合完整的中文文档，你可以用中文快速看懂每一个功能，再通过全局搜索在数百个请求中瞬间定位目标。

它对你有什么用

Bruno 的定位很直接：把 API 信息存在你自己的电脑文件夹里，而不是某个云端账号里。

• 纯文本存储：请求、变量、脚本都是可读的.bru/.yml文件，diff、回滚、审查都省心
• 完全离线：数据留在你的设备上，没有云同步，隐私无忧
• 跨平台 + 有 CLI：Mac、Windows、Linux 都能跑，命令行还能批量执行整个集合
• 有中文文档：官方提供简体中文 Readme 与贡献指南，上手不用硬啃英文

三步开始上手

第一步：安装 Bruno

从官网下载对应系统的安装包，或者用包管理器一行命令装好：

• Mac：brew install bruno（Homebrew）
• Windows：choco install bruno（Chocolatey）或 Scoop
• Linux：Snap 或 Apt 均可

安装完成后启动应用，第一次打开是英文界面，别慌，下一步就解决语言问题。

第二步：打开或创建你的第一个集合

集合（Collection）在 Bruno 里就是一个普通文件夹，里面用.bru文件描述请求。你可以：

1. 在欢迎页选择Open Collection，指向一个已有集合文件夹
2. 或选择Create Collection，让 Bruno 帮你新建一个空集合
3. 也可以Import Collection，把 Postman、OpenAPI 等格式的集合导入进来

新建一个请求文件，填入 URL 和请求体，点击发送，右侧就能看到响应体、状态码和耗时。

第三步：用中文文档对照学习界面

当前版本的界面语言是英文（国际化配置入口见 packages/bruno-app/src/i18n/index.js，翻译文件 目前只有英文一套）。好消息是，官方的中文文档是齐全的：简体中文文档覆盖了安装、特性、版本控制等全部内容，界面术语基本一一对应。建议开着中文文档对照操作：文档里写"通过 Git 协作"，界面上对应的就是集合文件夹加版本控制，几分钟就能建立映射。

从发送请求到高效搜索

核心工作流只有四步：新建请求 → 配置 URL、Headers、Body → 发送 → 查看响应。变量插值（如{{baseUrl}}/users）让你在不同环境间无缝切换，脚本（pre-request / post-request）则可以自动设置断言和提取变量。

搜索是这个工作流的加速器。任何时候按⌘K（Mac）/Ctrl+K（Windows）唤起全局搜索，输入关键词即可在集合、文件夹、请求三个层级里过滤定位，几百个请求的集合也能秒出结果。快捷键可在设置里的 Keybindings 页面自定义，绑一个你习惯的组合即可（见 偏好设置快捷键配置）。

版本控制与团队协作

因为集合就是本地文件夹，版本控制几乎是"零成本"的：

• 在集合目录执行git init并提交，每次改动都有完整历史
• 同事拉取仓库后直接用 Bruno 打开，无需任何同步服务
• 冲突时改的是纯文本.bru文件，diff 清晰、合并容易

CLI 批量操作是团队协作的另一块拼图。安装@usebruno/cli后，进入集合目录即可用命令执行整套请求，接入 CI 做自动化测试非常自然：

bru run folder --env Local --output results.json

它支持按文件、按子目录运行，指定环境，并导出 JSON 结果；还能用bru import openapi把 OpenAPI 规范直接转成 Bruno 集合。更多用法见 CLI 源码 与 CLI 说明文档。

进阶玩法

• 在熟悉的编辑器里看请求：集合就是文本文件，用 VSCode 或任何编辑器都能直接浏览、修改.bru文件，和 Bruno 图形界面互不干扰。
• 多平台无缝切换：Mac、Windows、Linux 行为一致，换设备只要把集合文件夹拷过去即可。
• 自动化测试进阶：结合 Playwright 测试指南 的测试组织思路，你可以把 Bruno 集合纳入更大的测试体系。

常见问题 FAQ

Q：界面为什么是英文？有中文版吗？当前应用界面暂只内置英文（i18n 翻译文件目前仅一套英文）。不过 中文文档 和 中文贡献指南 都很完整，可以先用文档对照着学。如果你熟悉 i18next，也可以参考 i18n 入口 提交中文翻译，这正是社区很需要的贡献方向。

Q：请求太多了，如何快速搜到目标请求？按⌘K/Ctrl+K打开全局搜索，直接输入请求名或文件夹名的关键词。它同时覆盖集合、文件夹、请求三个层级，不需要在左侧树里一层层展开找。

Q：请求存在哪里？换电脑会丢吗？所有请求都在你选择的本地文件夹里，是纯文本文件，随文件夹一起拷贝或用 Git 同步即可，不存在"账号里找不回来"的问题。

Q：不打开图形界面，能批量跑测试吗？可以。用 CLI 的bru run即可在终端、CI 里批量执行集合，配合--env切环境、--output导出结果，详见 CLI 命令实现。

Bruno 把"API 工具"做成了一个可以放进 Git 的本地文件夹，中文文档补齐了学习门槛，全局搜索和 CLI 则负责效率。装好它，先从一个 5 个请求的小集合开始，你会很快习惯这种纯文本的工作方式。

相关资源

• 官方中文文档：docs/readme/readme_cn.md
• 中文贡献指南：docs/contributing/contributing_cn.md
• 核心应用源码：packages/bruno-app/src/
• CLI 源码与说明：packages/bruno-cli/

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