Bruno 安装指南Windows、macOS、Linux 三平台装好并发出第一个请求【免费下载链接】brunoOpensource IDE For Exploring and Testing APIs (lightweight alternative to Postman/Insomnia)项目地址: https://gitcode.com/GitHub_Trending/br/bruno想把 API 集合提交进 Git 仓库却发现手头的工具全依赖云账号Bruno 安装本身不复杂这篇适合刚接触它的开发者按文操作你可以在 Windows、macOS 或 Linux 上完成 Bruno 安装验证桌面端与 bru CLI 两条链路并发出第一个请求。先认识 Bruno存在文件夹里的 API 客户端Bruno 是一个开源的 API 调试与测试客户端请求集合直接存放在你电脑的一个普通文件夹里每个请求对应一个 .bru 纯文本文件。它离线工作、没有云同步集合目录可以整体交给 Git 管理。用任意文本编辑器打开 .bru 文件都能读懂这也是它能进版本控制的原因。理解这一点很重要装完 Bruno 后你面对的不是某个私有库账号而是一个可以直接复制、diff、评审的目录。开始动手前先花十秒确认系统版本能避开后面大半的安装报错。确认三平台的系统要求平台最低版本最快安装方式WindowsWindows 10 及以上ChocolateymacOS10.15 (Catalina) 及以上HomebrewLinuxUbuntu 18.04 / Debian 10Snapbru 命令行工具独立安装只要求 Node.js 环境正常后面单独处理。三个平台都达标的话直接走下面这条最快的路。一条命令装完桌面端Windows 用户在 PowerShell 里执行这条 Chocolatey 命令装完后从开始菜单启动 Brunochoco install brunomacOS 用户打开终端用 Homebrew 一行装好然后从启动台启动brew install brunoLinux 用户Ubuntu/Debian用 Snap 安装装完从应用列表启动snap install bruno如果你的包管理器不在上面三个里或者想手动装下面这些备选路径都能走通。换一条路也能装上Windows 也可以走 Scoopscoop bucket add extras scoop install bruno或 wingetwinget install Bruno.Bruno。macOS 偏好手动安装的到 官方文档 安装章节的下载入口拿到 DMG拖进应用程序文件夹即可。Linux 上 Flatpak 的命令是flatpak install com.usebruno.Bruno用 Apt 的话需要先把 Bruno 官方源加进系统完整命令如下行内注释标出了关键步骤sudo mkdir -p /etc/apt/keyrings sudo apt update sudo apt install gpg curl # 准备导入签名所需的工具 curl -fsSL https://keyserver.ubuntu.com/pks/lookup?opgetsearch0x9FA6017ECABE0266 \ | gpg --dearmor \ | sudo tee /etc/apt/keyrings/bruno.gpg /dev/null # 导入 Bruno 官方 GPG 签名 sudo chmod 644 /etc/apt/keyrings/bruno.gpg echo deb [archamd64 signed-by/etc/apt/keyrings/bruno.gpg] http://debian.usebruno.com/ bruno stable \ | sudo tee /etc/apt/sources.list.d/bruno.list # 写入 Bruno 软件源 sudo apt update sudo apt install bruno桌面端就位后再把 bru 装上然后一次性验证两条链路。装好 bru 并三步验证两条链路bru 是 Bruno 的命令行工具源码在 packages/bruno-cli/用 npm 全局安装npm install -g usebruno/cli它和桌面端共用同一套集合文件夹能递归跑完一个目录下的请求和断言验证分三步。第一步启动 Bruno新建请求把 URL 填成https://echo.usebruno.com点 Send右侧出现 JSON 响应说明桌面端正常。第二步在终端执行bru --version能打印版本号说明 CLI 安装成功。第三步在任意集合目录下执行bru run my-collection --env Localbru run的输出会按请求逐条列出断言结果失败项一目了然方便定位是哪一步挂了。看到通过统计就代表桌面端和 CLI 都可用。集合想长期协作交给 Git 是最顺的姿势。把集合文件夹放进 Git集合就是一个普通目录对文件夹执行git init或把它加进已有仓库请求的新增和修改会像代码一样留下 diff 与记录。多人同时改一个集合时冲突发生在文本行级别合并成本比二进制格式低得多。注意环境变量文件里可能存着密钥建议只在本地维护、不要随集合提交。评审时 .bru 的改动一眼可读这正是把集合放进版本控制的底气所在如果卡在安装或验证环节先对照下面三个高频问题排查。装不上或跑不起来怎么办应用装上了却打不开对照前面的表格确认系统版本达标用包管理器重装一次如choco install bruno它会自动覆盖旧版本仍不行就查看应用日志定位报错再带着日志反馈给社区。bru 命令提示找不到先执行node -v确认 Node.js 环境正常全局卸载后重装npm uninstall -g usebruno/cli npm install -g usebruno/cli重开终端再执行bru --version复验。apt 安装报签名错误单独重跑 apt 命令块里 GPG 导入的那几行执行sudo apt update确认 Bruno 源能正常拉取仍报错就检查代理设置或系统时间同步后再试。装好并验证通过后可以顺着 官方中文文档 了解环境变量与请求脚本想参与改进就看 contributing.md。下一步建议给集合配上环境变量再用 bru run 把整个集合接进 CI 流水线。【免费下载链接】brunoOpensource IDE For Exploring and Testing APIs (lightweight alternative to Postman/Insomnia)项目地址: https://gitcode.com/GitHub_Trending/br/bruno创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考