企业官网建设流程全解析

Bruno API 客户端快速上手指南：从本地集合到全局搜索完整走查

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

当你需要快速验证同事刚写好的接口，而集合里已有几百个请求时，你需要的是一款完全掌控在本地的 API 客户端——Bruno。它把每个请求存成纯文本.bru文件，可搜索、可 diff、可交给 Git 管理。读完这篇指南，你能完成安装与首次请求，并用全局搜索在大型集合中秒级定位任意请求。

🧭 能力全景

先看看这款开源 API 测试工具能做什么：

• 本地集合存储：请求、环境变量、脚本全部保存在本地文件夹的纯文本中，离线可用、无云端依赖
• 全局搜索：按Command/Ctrl + Shift + K一次检索当前工作区所有集合
• CLI 与 CI/CD：命令行执行bru run即可跑完整集合，官方还提供 Docker 镜像
• 版本控制友好：纯文本格式让 API 集合像代码一样提交、评审、回滚

图：Bruno API 客户端主界面，请求编辑与响应查看都在本地完成

🚀 从 0 到 1 上手路径

第 1 步：安装客户端。macOS 上执行brew install bruno，Windows 上执行choco install bruno，然后打开 Bruno。做完你会看到空工作区的欢迎页。

第 2 步：打开一个集合。点击Open Collection，指向任意包含.bru文件的本地文件夹。做完你会看到侧边栏列出该集合的全部请求与文件夹。

第 3 步：发送首个请求。双击任一请求，在Environments页签填入变量值，点击Send。做完你会看到下方出现状态码、响应头与响应体。

第 4 步：配置环境。把 local、test 等环境写入environments文件夹，用顶部环境切换器选择。做完你会看到同一请求在不同环境自动使用正确的基地址。

第 5 步：体验全局搜索。按搜索快捷键，输入请求名开头几个字符。做完你会看到匹配到的请求、文件夹与路径列表，点击即跳转到对应标签页。

🔍 深度场景实战：大型集合里找请求并提交

搜索和 Git 的组合，是这套工作流里最值钱的一环。先说搜索：全局搜索是多词全部匹配，输入user login只会命中名称或路径同时包含这两个词的请求；找中文请求时直接输中文关键词即可，所有文件都是 UTF-8 纯文本，中文与英文一样可精确匹配。只想在单个集合内过滤时，用侧边栏的过滤输入框更合适。

找到请求、改完内容后，直接git commit。每个请求就是一个.bru文件，diff 清晰得像代码评审。

图：API 集合即纯文本文件夹，Git 可直接追踪每次请求变更

一条铁律：搜索是多词与关系，找不到就减词，而不是加词。

⚠️ 高频误区与纠偏

• 误区：在设置里找中文界面开关 →正确做法：应用界面为英文，无需配置；请求参数、响应体、文档里的中文内容本身就正常显示与搜索，不存在编码设置
• 误区：以为多个词是“或”关系 →正确做法：全局搜索为 AND 匹配，放宽容差时少输词，再用侧边栏过滤框收窄范围
• 误区：把 Postman 云端集合直接搬过来用 →正确做法：Bruno 明确不做云同步，先用导入功能把导出的集合文件转成本地文件夹，再纳入 Git

🧩 选型与边界提示

适合：离线优先、代码仓库作为团队唯一事实源、需要在 CI 里反复跑断言的场景。CLI 的 Docker 镜像让你在流水线里免装 Node 也能跑集合：

图：用 bru run 在命令行执行整个集合，适合自动化测试

不适合：如果你依赖云端共享、浏览器协作或多设备自动同步，Bruno 不是你的答案——团队已明确表示永远不会加入云同步。这种情况请留在云端 API 客户端阵营。

📚 延伸资源

• 项目概览与安装说明：readme.md
• CLI 源码与测试用例：packages/bruno-cli/
• 贡献指南：contributing.md

打开你的 API 集合，按下Command/Ctrl + Shift + K，找到那个你找了几分钟的请求——搜索比鼠标更快。

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