Bruno API 客户端快速上手指南从本地集合到全局搜索完整走查【免费下载链接】brunoOpensource IDE For Exploring and Testing APIs (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 brunoWindows 上执行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.mdCLI 源码与测试用例packages/bruno-cli/贡献指南contributing.md打开你的 API 集合按下Command/Ctrl Shift K找到那个你找了几分钟的请求——搜索比鼠标更快。【免费下载链接】brunoOpensource IDE For Exploring and Testing APIs (lightweight alternative to Postman/Insomnia)项目地址: https://gitcode.com/GitHub_Trending/br/bruno创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考