Bruno CLI 实操手册：从零跑通 API 集合

Bruno CLI 实操手册从零跑通 API 集合【免费下载链接】brunoOpensource IDE For Exploring and Testing APIs (lightweight alternative to Postman/Insomnia)项目地址: https://gitcode.com/GitHub_Trending/br/brunoBruno 把 API 集合存成本地纯文本文件本文聚焦 Bruno CLI如何在命令行批量执行 .bru 请求、切换环境并输出报告读完即可把 API 测试接入本地和 CI 流水线。适用场景与价值本地集合用 Git 共享成员拉下同一目录执行结果一致。发版前批量跑接口回归比在桌面端逐个点击快得多。CI 流水线里无人值守执行 Bruno API 测试失败自动红灯。环境准备与快速启动装 Bruno 桌面应用包管理器搜 bruno 或官网下载。全局装 CLInpm install -g usebruno/cli进入集合目录执行bru run能看到逐条请求结果即为就绪。核心功能逐项拆解bru run三种执行粒度一条命令覆盖整个集合 / 单个请求 / 整个文件夹集合根目录执行bru run跑全部请求。bru run request.bru只跑指定请求文件。bru run folder --env Local跑文件夹并指定环境。bru run auth/ --env Test在 CI 里同样适用一个文件夹即一组可重复执行的回归用例。环境与变量 ⚡--env选择环境--env-var临时覆盖单个变量打开environments/记下环境文件名。加--env传入文件名。需要临时改值时追加--env-var 名值。bru run --env Local --env-var tokenabc123适合流水线里注入临时密钥不用改动环境文件。输出与报告--output把执行结果写入文件--format控制格式json 或 junit先确认目标目录已存在。加--output results.json输出 JSON 结果。加--format junit换成 CI 系统通用的 JUnit 报告。bru run folder --output results.json --bail--bail让首个失败就停能节省流水线时间。导入外部文档bru import openapi把 OpenAPI 文档转成 Bruno 集合目录准备本地 spec 文件或可访问的 URL。执行导入指定输出目录与集合名。打开生成的目录即可直接bru run。bru import openapi -s api.yml -o ./my-collection -n My API一份文档一次导入免去手工逐条录入接口。典型工作流串联在 Bruno 中写好 .bru 请求与断言纯文本中文注释不乱码。把集合目录提交 Git队友 clone 后目录结构不变。本地验证bru run --env Local。CI 里跑bru run --env Prod --output report.json报告随产物归档。集合在本地、Git、CI 三处行为一致这是 .bru 纯文本格式带来的直接好处。容易踩的坑现象提示集合根目录外退出码 4。原因bru 在集合之外执行。修复cd 进含 bruno.json 的目录再跑。现象退出码 6环境找不到。原因--env名称与environments/文件名不一致大小写也敏感。修复核对文件名后重跑。现象断言失败CI 任务却显示成功。原因bru 以退出码 1 表示失败流水线没把它判为失败。修复CI 步骤里把非 0 退出码处理为失败。配置自查清单Node.js 与 bru 命令均可用bru --version集合根目录存在bruno.jsonenvironments/中包含所有要跑的环境文件--output目标目录已存在CI 步骤已把非 0 退出码处理为失败.bru文件以 UTF-8 编码保存中文注释正常Bruno 让 API 测试变成可版本化的纯文本动手跑通你的第一个集合吧。更多细节可查阅 CLI 说明。【免费下载链接】brunoOpensource IDE For Exploring and Testing APIs (lightweight alternative to Postman/Insomnia)项目地址: https://gitcode.com/GitHub_Trending/br/bruno创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考