
如何快速上手 Bruno从单个请求到团队 API 测试的完全指南【免费下载链接】brunoOpensource IDE For Exploring and Testing APIs (lightweight alternative to Postman/Insomnia)项目地址: https://gitcode.com/GitHub_Trending/br/bruno这篇文章带你在 10 分钟左右完成 Bruno 安装、发出第一个 API 请求并把整个集合批量跑起来。Bruno 是一个开源 API 客户端Postman 的轻量替代品你的集合会以纯文本文件形式存放在本地磁盘上。它是什么适合谁Bruno 是一个离线优先的开源 API 探索与测试工具集合直接存放在你本地的一个文件夹里每个请求用名为 Bru 的标记语言存成纯文本文件官方明确不做云同步。它适合每天要调试接口的后端、前端开发也适合想把 API 断言放进 CI 流水线的测试团队。五分钟跑起来以 Mac 为例全程不超过 5 分钟Mac 上执行brew install bruno安装启动 Bruno选择 Open collection指向一个空文件夹作为你的集合侧边栏点 新建一个请求填 URL 后点 Send查看响应跟着做完一个完整任务这个任务把整个集合的请求和断言一次性验证完安装 CLInpm install -g usebruno/cli终端cd进集合根目录也就是含bruno.json的那层执行bru run --env Local递归运行文件夹里全部请求看输出每个请求打印状态码和每条 assert 的通过情况CLI 还支持bru run request.bru只跑单个请求加--output results.json把结果导出成 JSON 存档。到这里你就已经可以把接口测试接入 CI 流水线了。让效率再翻一倍的配置用 environments 文件夹切换多环境在集合的environments/文件夹里为每个环境放一个文件顶部右侧下拉框切换。请求里的{{变量}}引用会自动解析一套集合同时指向开发和生产 URL。在请求的 tests 段里写断言在请求文件的tests { }块里写assert(res.status 200)。断言跟着文件走界面发送或 CLI 运行都会自动执行并给出通过数。从集合生成 Markdown 文档在集合头部开启 Docs 功能Bruno 会按文件夹结构和各请求内容生成 markdown。把它提交进仓库接口文档就和代码同步了。导入现有 OpenAPI 文档执行bru import openapi -s api.yml -o ~/my-collection直接由 OpenAPI 规范生成一个 Bruno 集合再进图形界面补细节。数据怎么管、怎么共享数据模型很简单集合就是一个文件夹请求、变量、文档全是纯文本文件由此带来两件事。版本控制零成本在集合文件夹里git init即可.bru 文件的 diff 在 PR 里可读性很高回滚就是git checkout互操作不费劲CLI 能导入 OpenAPI图形界面也支持导入 Postman 和 OpenAPI 集合文件格式的完整示例见 bruno-lang 包的样例。踩坑速查现象原因解决改 .bru 文件界面没刷新文件监听偶发不触发切走再切回标签页或重新打开集合请求里{{变量}}原样发出当前环境没定义该变量检查environments/文件里变量名拼写bru run提示找不到集合终端不在集合根目录cd到含bruno.json的文件夹再跑响应里中文是乱码响应体编码非 UTF-8查看响应头Content-Type的 charset搜中文关键词无结果搜索按文件名、标题和内容匹配换英文关键词或按请求文件名搜带走前再看一眼集合就是本地一个文件夹请求是.bru纯文本文件GUI 用brew install brunoCLI 用npm install -g usebruno/cli环境放environments/文件夹右侧下拉框切换断言写在请求文件tests { }里每次运行自动执行集合交给 gitdiff 和回滚都是现成的记住这五条你的 API 工作流就搭好了。【免费下载链接】brunoOpensource IDE For Exploring and Testing APIs (lightweight alternative to Postman/Insomnia)项目地址: https://gitcode.com/GitHub_Trending/br/bruno创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考