Bruno 集合本地文件存储一次上手【免费下载链接】brunoOpensource IDE For Exploring and Testing APIs (lightweight alternative to Postman/Insomnia)项目地址: https://gitcode.com/GitHub_Trending/br/bruno你一定遇到过这种场景同事发来的 API 集合用云工具打开要先导入想看两个版本之间改了什么只能肉眼比对。Bruno 把这件事变成把集合存成本地文件整个集合就是一个装满 .bru 纯文本文件的文件夹用任意编辑器能改用版本控制能对比。Bruno 集合原理速览文件都存在哪Bruno 不把集合数据放进数据库。一个集合就是一个文件夹bruno.json描述集合配置每个.bru文件是一个 API 请求environments/子目录存放各环境的变量。全部内容都是纯文本Bruno 也完全离线工作官方 README 明确写明了没有云端同步计划数据始终留在你自己的设备上。Bruno bru 文件首次上手搭好第一个集合最短路径是这样准备一个文件夹放入bruno.json和几个.bru请求文件用 Bruno 打开这个文件夹。最常见的三类文件是文件说明示例值bruno.json集合配置文件声明版本、名称、类型type: collection、name: my-apiping.bru一个 .bru 文件对应一个请求get { url: {{host}}/ping }environments/Local.bru每个环境一份变量集用{{ }}引用vars { host: http://localhost:8080 }请求文件本身是纯文本meta块声明请求名和类型get块声明方法、URL变量用{{变量名}}写进 URL 里。打开文件夹就能发请求响应直接显示在界面里少一步导出、少一次导入。仓库里有一份现成的示例集合可以直接参考测试集合。进阶场景Git 协作与 CI 自动化交给 Git 管理。集合文件夹进了版本控制之后协作就是一次 push 和 pull。请求、环境、变量的改动都是文本 diff谁改了什么一眼可见重启电脑、换台机器打开都不丢东西。用 CLI 跑进流水线。装好 Bruno CLI在集合目录执行bru run就能跑完全部请求--env Local指定环境--output results.json把结果落成文件直接接进 CI。完整用法见 Bruno CLI 的说明和命令实现。给敏感变量上锁。存放 token、密钥的变量名写进vars:secret列表里Bruno 会按敏感字段处理它们避免随手 commit 进仓库。踩坑清单常见错误怎么处理现象原因处理切换环境后请求还打到旧域名请求里的变量名和环境文件对不上或环境选择器没切对照environments/*.bru里的vars确认变量名一致且选中了目标环境Bruno 不认这个文件夹是集合缺少bruno.json或它不在文件夹根部在根部补上配置文件至少包含version、name、type三项bru run报找不到请求在错误的目录里执行进入包含bruno.json的文件夹再执行token 出现在仓库 diff 里敏感变量写在普通vars里把变量名移入vars:secret列表集合当成文件夹管理之后版本合并、手工调试、CI 跑测都围绕同一份文本文件少一份副本、少一次同步。想继续深入可以看 官方中文 README按贡献指南提 Issue 参与讨论也可以。【免费下载链接】brunoOpensource IDE For Exploring and Testing APIs (lightweight alternative to Postman/Insomnia)项目地址: https://gitcode.com/GitHub_Trending/br/bruno创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考