Bruno 完整入门指南：三步搭建本地优先的 API 测试工具箱

Bruno 完整入门指南三步搭建本地优先的 API 测试工具箱【免费下载链接】brunoOpensource IDE For Exploring and Testing APIs (lightweight alternative to Postman/Insomnia)项目地址: https://gitcode.com/GitHub_Trending/br/bruno写接口测试脚本为什么总在环境配置上浪费时间如果你也在写接口测试脚本大概率被这些事绊过脚请求散落在同事的 Postman 云账号里、每次换环境要手动改域名、想复现一次调试却要导来导去一堆 JSON。Bruno 就是冲着这些痛点来的——它是一个开源的 API 客户端IDE把整个请求集合直接存成你电脑文件夹里的纯文本文件。这意味着接口定义天然可 diff、可提交 Git、可以离线打开相当于把请求管理从云端搬回了你本地的文件系统。Bruno 是什么一个本地优先的 API 客户端一句话定位Bruno 是 Postman / Insomnia 的轻量替代核心差异是一切都在本地。它用一种叫 Bru 的纯文本标记语言保存请求也有配套的.yml格式不要求账号、不依赖云端同步官方甚至明确承诺永不加入云同步功能。维度Bruno传统云端 API 工具集合存储位置本地文件夹纯文本.bru/.yml云端账号私有 JSON 格式团队协作直接提交 Gitdiff 可读依赖账号共享或导出文件运行环境桌面端、CLI、VS Code桌面端 云端离线可用性完全离线多数功能需要联网三步跑通安装、启动、发出第一个请求第 1 步安装 Bruno。官方提供 Mac / Windows / Linux 的二进制安装包也支持主流包管理器。挑一种你顺手的# macOS brew install bruno # Windows winget install Bruno.Bruno # Linux (Snap) snap install bruno装完在系统里启动 Bruno你应该看到一个带侧边栏请求树的空界面顶部有 Open Collection 入口。第 2 步打开或新建一个集合。集合就是一个文件夹里面有个bruno.json描述集合元信息可以参考仓库自带的测试集合 packages/bruno-tests/collection。在 Bruno 里点 Open选中你的集合文件夹即可。如果习惯命令行也可以直接 clone 源码仓库后按 官方 README 的说明本地开发运行。第 3 步发第一个请求。右键新建一个 Request填入方法和 URL比如GET https://echo.usebruno.com点 Send。name Get Ping method GET url https://echo.usebruno.com/ping注意这里右侧应该立刻出现 200 状态码、响应头和响应体三个标签页——这就是你完整的第一个 Bruno API 测试用例。切到 Assert 标签加一条expect(res.status).to.equal(200)以后这个请求就能当回归测试跑。进阶用法把 Bruno 当工程来用跑通之后真正拉开差距的是下面两件事。用 Git 管理请求集合。因为请求就是纯文本文件团队协作退化成最熟悉的 Git 流程建分支、提 PR、review 文本 diff、合并。你甚至可以在 PR 里逐行审查一个请求改了哪个头、换了哪个断言用 Bruno CLI 把集合接入 CI。桌面端负责调试bru run负责批量执行一条命令就能跑完整个集合并输出 JSON / JUnit 报告退出码还能直接作为流水线门禁npm install -g usebruno/cli bru run folder --env Local --output results.json执行结果长这样每个断言是否通过一目了然完整参数--env-var覆盖变量、--reporter-junit报告、--bail失败即停等可以看 Bruno CLI 文档。适合谁以及接下来去哪如果你的日常是调接口 写点断言 偶尔跑回归又受够了把请求数据托管在第三方云端Bruno 基本是目前最对口的开源选择团队规模再大一些它的 Git 协作模式和 CLI 也足够撑到 CI/CD 层面。想继续深入可以从 中文 README 和 贡献指南 入手前者覆盖多语言文档入口后者带你熟悉这个 monorepo 里bruno-app界面、bruno-cli命令行、bruno-requests请求执行等模块的分工——读完你就会明白为什么它的每个功能都能落回本地文件。【免费下载链接】brunoOpensource IDE For Exploring and Testing APIs (lightweight alternative to Postman/Insomnia)项目地址: https://gitcode.com/GitHub_Trending/br/bruno创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考