Bruno 安装教程3 步跑通本地环境用纯文本 API 集合告别浏览器调接口【免费下载链接】brunoOpensource IDE For Exploring and Testing APIs (lightweight alternative to Postman/Insomnia)项目地址: https://gitcode.com/GitHub_Trending/br/bruno还在把接口请求散落在浏览器、JSON 和备忘录里Bruno 是一个开源的 API 调试桌面客户端请求全部存成纯文本 .bru 文件放在你自己的文件夹里离线使用。想找一个轻量替代 Postman 的开发者值得花十分钟认识它。凭什么是 Bruno你的痛点请求散在浏览器和 Postman 账号里没法进代码仓库。Bruno 把集合直接存在本地文件夹里——请求即文件用纯文本的 .bru 格式保存。这意味着 Git diff、code review、多人协作全都成立你的接口资产第一次真正跟代码放在一起。你的痛点工具强制账号和云端同步。Bruno 完全离线官方明确表示没有云端同步的计划。接口信息、环境变量都留在本地磁盘适合对数据敏感的团队。你的痛点GUI 里跑通的测试没法进 CI 流水线。Bruno 自带 CLI同一份集合在界面里调试在命令行里批量执行CI 里一条命令就能跑完。从它凭什么落到怎么跑起来。先说清一件事Bruno 是 React Electron 的桌面应用代码用 npm workspaces 拆成一堆子包开发环境要求 Node v22.x 或最新 LTS具体见 contributing.md。三步跑通 Bruno 开发环境先克隆仓库并装依赖git clone https://gitcode.com/GitHub_Trending/br/bruno cd bruno nvm use npm i --legacy-peer-deps跑完你会在packages/下看到一堆子包node_modules装好即可。注意一定要带--legacy-peer-deps这是项目自己的惯例原因见后面的避坑部分。然后一条命令完成初始化npm run setup这个脚本会清理旧的node_modules、装依赖、逐个构建 bruno-common 等子包。它跑完你不需要看构建细节只要看到 Setup completed successfully 就对了。最后启动开发环境npm run dev一个 Electron 窗口会弹出来这就是 Bruno 的主界面——新建集合、发请求、看响应跟你在 Postman 里做的动作一样只是你的请求落在本地 .bru 文件里。桌面端跑通了再看它最能打的场景CLI 和团队协作。当你想在 CI 里跑测试的时候Bruno 的 CLI 叫brunpm 全局装一下npm install -g usebruno/cli。然后在集合目录下bru run # 跑集合里所有请求 bru run request.bru # 只跑一个 bru run folder --env Local # 指定环境跑一个文件夹跑完你会看到每个请求的通过/失败结果。bru的退出码有约定0 是成功1 是断言或请求失败——在 CI 里这就是现成的流水线判定信号。加--output results.json或--reporter-junit还能导出报告直接接入现有 CI。命令全集见 CLI readme。当你想把集合交给团队的时候集合就是一个文件夹直接用 Git 管。.bru是纯文本长这样取自 packages/bruno-lang/example/request.brumethod GET url https://api.example.com/data headers 1 content-type application/json /headers同事 clone 下来就能打开整个集合改动用 Git diff 逐行可见。bru run的--env参数配合集合里的 environments 目录能区分本地、测试环境避免把某人的私人配置提交进去。新手最常踩的 3 个坑现象装依赖或构建时报奇怪的错。解决确认 Node 版本是 v22.x 或最新 LTSBruno 对版本有硬性要求用nvm use切过去再装。现象npm install直接 peer 依赖冲突失败。解决加上--legacy-peer-deps重装项目自己的 setup 脚本就是这么跑的。现象bru run直接退出并报错。解决bru必须在集合根目录有 .bru 文件的目录执行在别处运行会返回退出码 4跑错环境名也是同理先检查--env拼写。跑通只是开始下面说说它和老邻居们怎么分工。周边工具与延伸阅读Postman / Insomnia功能上同类的 API 客户端集合默认存在账号云端Bruno 的集合是本地文件进 Git 是一等公民两者定位的差异基本就一句云端 vs 本地。导入工具Bruno 支持从 Postman、Insomnia、OpenAPI 导入集合转换器源码在 packages/bruno-converters从老工具迁移不用手工重做。Docker不想在主机装 NodeCLI 有官方 Docker 镜像docker run挂载集合目录执行usebruno/cli run即可适合一次性环境细节见 packages/bruno-cli/docker/README.md。【免费下载链接】brunoOpensource IDE For Exploring and Testing APIs (lightweight alternative to Postman/Insomnia)项目地址: https://gitcode.com/GitHub_Trending/br/bruno创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考