30 分钟玩转 BrunoAPI 测试中文支持与搜索提效完整指南【免费下载链接】brunoOpensource IDE For Exploring and Testing APIs (lightweight alternative to Postman/Insomnia)项目地址: https://gitcode.com/GitHub_Trending/br/brunoBruno 是一款开源的 API 测试工具定位是 Postman、Insomnia 的轻量级替代品它把请求集合以纯文本文件放在你自己的文件夹里天然贴合 Git 工作流界面也足够克制。对国内开发者来说它还有两个值得花点时间弄明白的点——中文资料与界面到底能用到什么程度以及怎么把内置的搜索能力用出效率。这篇指南按「上手 → 中文体验 → 搜索技巧 → 本地集合协作 → 进阶自动化」的顺序讲看完就能动手。先想清楚为什么你要换一个 API 工具用过 Postman 的人大概都踩过类似的坑请求存在云端、换台电脑要重新同步、想给团队做权限还得付费。Bruno 的思路相反——集合就是一个文件夹每个请求是一个.bru文本文件环境、变量、断言全在文件里。这带来三个直接好处版本控制零成本git commit就能回溯每一次请求改动没有强制的云账号离线可用内网环境也不受影响文件是文本代码评审、CI 里跑测试、批量改名都顺手。如果你现在的需求是「本地管理请求 团队协作 CI 自动化」Bruno 基本能覆盖如果是重度依赖云协作、大规模权限体系那再评估也不迟。快速上手三个动作跑通第一个请求下载安装Bruno 支持 Windows、macOS 和 Linux从官方渠道下载对应安装包即可。如果你想在阅读源码的同时把玩这个项目也可以直接拉一份到本地git clone https://gitcode.com/GitHub_Trending/br/bruno打开集合启动后在欢迎页选择「打开集合」指向任意一个 Bruno 集合文件夹仓库里 packages/bruno-tests/ 就有一套现成的真实集合拿它练手很好用。读懂.bru文件一个请求文件大概长这样——头部声明方法与 URL中间是请求体test块写断言require块写前置逻辑。它不是 JSON而是为可读性设计的文本格式解析与序列化逻辑都在 bruno-lang 包 里。改完文件 Bruno 会即时监听变化不用手动刷新。中文设置与界面阅读把 Bruno 用顺国内用户打开 Bruno 第一反应通常是「怎么是英文的」这里把现状讲透避免大家走弯路。资料与界面各是什么情况先说结论项目内置的中文文档是现成的而 UI 翻译目前以英文为主中文界面可基于现有框架自行扩展。仓库自带简体中文的 readmedocs/readme/readme_cn.md和多语言贡献指南功能介绍、安装步骤都能直接对照着看界面国际化走的是标准方案入口在 packages/bruno-app/src/i18n/index.js使用 i18next react-i18next当前注册的核心翻译资源是 en.json。也就是说翻译文案都集中在translation目录里统一管理想补充其他语言条目照着这个结构加文件就行——这对想贡献中文本地化的开发者是个很低的门槛。三条让英文界面「不碍事」的建议变量名放心用中文。请求 URL、路径、请求名里出现中文关键词完全没问题因为搜索和插值都是按字符串匹配的后面会专门讲先认全五个高频区域左侧集合树、中间请求编辑区、下方响应面板、右侧环境/变量面板、底部快捷键提示。这五块覆盖了 90% 的日常操作把报错当学习材料。脚本报错直接落在请求页的错误栏行列号都会给出配合 bruno-js 的运行时行为排错路径很短。Bruno 搜索技巧两个面板用对地方集合规模一上来靠肉眼翻侧边栏就不可行了。Bruno 有两套搜索用途不同。全局搜索跨集合找请求和文件夹在集合较多时用快捷键唤起全局搜索面板具体键位可在 快捷键映射文件 里核对实现源码见 GlobalSearchModal。它一次扫描当前工作区下所有集合按「集合名 → 请求名 → 请求 URL → 文件路径 → 文件夹」分类给出结果并支持键盘上下选择、回车直达。两个实用技巧多词查询是 AND 关系输入的两个词必须同时命中才算匹配。查不到结果时优先删掉更泛的词而不是换同义词中文关键词直接可用。匹配逻辑是不区分大小写的字符串包含所以请求名叫「用户认证」时输入「认证」就能命中——起名字时把中文业务词放进行请名日后收益很大。编辑器内查找改配置时更顺手打开某个请求后编辑区内自带代码搜索CodeMirrorSearch支持在单个文件里查找、替换配置项比如把某个环境域名全局换掉。全局面板管「找到是哪个请求」编辑器查找管「在请求里改哪几行」分工这么用就不会乱。Bruno 本地集合的 Git 管理约定比工具更重要集合即文件夹协作从 .gitignore 开始因为集合就是纯文本目录Git 几乎是零配置接入的日常只需要两条约定集合目录git init后把环境里的敏感值如密钥用bru encrypt之类的机制处理或移出仓库bruno.json这类集合配置则正常提交保证所有人的默认行为一致。让历史可回溯的小习惯按「功能模块」而不是「测试人」分文件夹合并冲突会少一大半提交信息带上请求名评审时一眼能看出动了哪条 API分支上跑回归用后面要讲的 CLI 出报告主干更稳。进阶玩法CLI 与生态延伸把测试跑进 CI而不是只停留在界面里bruno-cli 让整套集合脱离图形界面运行这也是它进 CI 的关键。全局安装后在集合目录执行bru run user-auth --env dev --output report.json这条命令跑user-auth文件夹下所有请求、套用 dev 环境、把结果写成报告文件——接入 Jenkins / GitHub 流水线时只需两步检出代码、执行命令。想从 OpenAPI 规格批量生成集合用bru import openapi也能一步到位。生态延伸从文本格式到网络引擎集合格式之外Bruno 的网络请求由 bruno-requests 承担覆盖 HTTP、gRPC、GraphQL、WebSocket、SSE意味着你的「一个集合」可以是多种协议的混合体。而在编辑器环境里做开发时Bruno 的文本格式也让它和 VSCode 等 IDE 的配合很自然——一边写代码一边在旁边调接口比切回浏览器式工具顺畅得多。遇到问题去哪里排障顺序建议这样走先看请求页的错误栏行号定位最快→ 再翻 中文文档 里对应章节 → 最后在仓库的 issue 区搜关键词很多「中文显示」「编码」类问题都有现成讨论。动手修问题或补翻译前建议先过一遍贡献流程了解测试和提交规范。资源导航贡献指南含中文docs/contributing/contributing_cn.md发布流程说明docs/publishing/publishing_cn.md端到端测试集合packages/bruno-tests/网络请求引擎源码packages/bruno-requests/【免费下载链接】brunoOpensource IDE For Exploring and Testing APIs (lightweight alternative to Postman/Insomnia)项目地址: https://gitcode.com/GitHub_Trending/br/bruno创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考