Bruno 完整教程:把 API 调试集合成文本文件,用 Git 协作管理

Bruno 完整教程:把 API 调试集合成文本文件,用 Git 协作管理 Bruno 完整教程把 API 调试集合成文本文件用 Git 协作管理【免费下载链接】brunoOpensource IDE For Exploring and Testing APIs (lightweight alternative to Postman/Insomnia)项目地址: https://gitcode.com/GitHub_Trending/br/brunoBruno 是一款开源的 API 测试工具整套 API 集合以纯文本 .bru 文件存放在本地文件夹里不依赖云端账号还能直接用 Git 管理。本文带你从安装到多环境调试工作流一次跑通。集合散落各处Bruno 把它放进一个文件夹你可能遇到过这种情况团队的接口请求散落在各个账号的工作区里想交接、想回滚都困难。Bruno 的做法是把整个集合做成磁盘上的一个普通文件夹每个请求就是一个 .bru 纯文本文件。后端开发、前端联调、需要把请求沉淀进代码仓库的测试同学都适合直接上手。跑起来之后目录结构很直观请求按文件夹组织环境放在 environments/ 下集合级配置写在 bruno.json 里。Bruno 安装步骤三条命令跑通客户端按系统选包管理器一行装完# macOS (Homebrew) brew install bruno # Windows (Chocolatey) choco install bruno # Linux (Snap) snap install bruno装完打开应用用Open Collection指向任意一个文件夹即可。想从源码构建也可以直接拉仓库git clone https://gitcode.com/GitHub_Trending/br/bruno.git cd bruno npm install npm run dev客户端跑起来后新建一个请求写法极其简单本质就是一段文本method GET url {{host}}/api/users保存后它立刻落盘成文件你用任何文本编辑器改它客户端也会自动同步。Bruno 多环境配置一个文件切换测试和生产这是 Bruno 最核心的使用场景。在 environments/ 目录下为每个环境建一个文件例如 environments/Local.bruvars { host: http://localhost:8080 }请求 URL 里写{{host}}在应用右上角切换环境同一个请求就能从本地服务瞬间指向预发地址。命令行同样支持bru run ping.bru --env Local敏感值也可以写进程变量比如token: {{process.env.API_TOKEN}}密钥不落库、不进 Git 历史。配置与扩展三处最值得做对集合级共享配置。场景整个集合的请求都要带同一个 Bearer Token 和固定请求头。做法在集合根目录的 collection.bru 里写一次子请求自动继承也可以逐个覆盖。效果几十个请求不再需要逐个复制请求头。bruno.json。场景内网环境要走代理或希望新建请求时预填默认地址。做法在 bruno.json 里配置 proxy 与 presets 字段还能在 scripts.moduleWhitelist 里声明脚本可引用的模块白名单。效果集合一打开行为就是团队约定好的。Bruno CLI 接 CI。场景每次推送后自动跑一遍集合。做法npm install -g usebruno/cli bru run --output results.json --format junit效果退出码 0 表示全部通过非 0 即失败CI 里只检查退出码就能卡住问题请求。完整选项见 packages/bruno-cli/readme.md。三个组合把 Bruno 用到极致Git集合是纯文本直接提交进仓库请求变更能看 diff、走评审。Bruno 坚持完全离线、不做云同步这正是为这套流程设计的。Docker官方 usebruno/cli 镜像让你在 CI 里免装 Node 也能跑集合docker run -v $(pwd):/bruno usebruno/cli run。OpenAPI只有接口文档也能起步bru import openapi -s api.yml -o my-collection一条命令转成 Bruno 集合。落地建议把仓库里现成的示例集合 packages/bruno-tests/collection/ 拷到桌面用 Bruno 打开照着它理解请求、环境和脚本三者的组织方式。【免费下载链接】brunoOpensource IDE For Exploring and Testing APIs (lightweight alternative to Postman/Insomnia)项目地址: https://gitcode.com/GitHub_Trending/br/bruno创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考