5 条命令装完BrunoWin/Mac/Linux全平台实操【免费下载链接】brunoOpensource IDE For Exploring and Testing APIs (lightweight alternative to Postman/Insomnia)项目地址: https://gitcode.com/GitHub_Trending/br/brunoBruno 是一个开源的 API 测试客户端把请求存成本地.bru纯文本文件可以直接用 Git 协作。这篇文给你在 Windows、macOS、Linux 上装好桌面版和命令行工具bru的完整命令并顺手解决几个最常见的装不上、跑不起来的问题。环境速查表平台最低版本推荐安装方式Windows10 及以上Chocolatey / Scoop / wingetmacOS10.15 及以上Homebrew / 官网 DMGLinuxUbuntu 18.04 / Debian 10Snap / Flatpak / APT任意系统仅用 CLINode.js 18npm 全局安装桌面版负责点选调试CLI 负责批量执行和 CI 集成。只做自动化也可以只装bru跳过下面桌面版的步骤。安装路线总览先给你一张最短路径的命令表。每个平台挑一行执行即可详细参数和踩坑点放在后面各节里平台包管理器命令WindowsChocolateychoco install brunoWindowsScoopscoop bucket add extras然后scoop install brunoWindowswingetwinget install Bruno.BrunomacOSHomebrewbrew install brunoLinuxSnapsnap install brunoLinuxFlatpakflatpak install com.usebruno.BrunoLinuxAPT见下文Linux 添加 Bruno APT 源并安装Bruno 的核心逻辑是整个 API 集合就是一个本地文件夹左侧树形面板里每个请求对应一个.bru文件和文件管理器里的一一对应Windows 用包管理器安装 Bruno 桌面版三种方式任选其一装的都是同一个桌面版。用 Chocolatey 安装 Brunochoco install bruno用 Scoop 安装 BrunoScoop 的 Bruno 在 extras 桶里先加桶再装scoop bucket add extras scoop install bruno用 winget 安装 Brunowinget install Bruno.Bruno⚠️ 装完打不开的话先看系统是不是 Windows 10 以下。确认没问题就重新执行一遍安装命令再查应用日志定位原因。安装完成后在开始菜单里搜索 Bruno 就能启动。macOS 安装 BrunoHomebrew 或 DMG用 Homebrew 安装 Brunobrew install bruno下载 DMG 安装包从 Bruno 官网下载 macOS 的 DMG双击打开把 Bruno 图标拖进 Applications 文件夹即可。⚠️ 如果 DMG 装完提示无法验证开发者去系统设置 → 隐私与安全性里点仍要打开之后就不会再拦了。Linux 添加 Bruno APT 源并安装用 Snap 安装 Bruno最省事一条命令snap install bruno用 Flatpak 安装 Brunoflatpak install com.usebruno.Bruno用 APT 添加 Bruno 源并安装Debian / Ubuntu这段命令依次完成建 keyrings 目录、导入 Bruno 的 GPG 公钥、写入源列表、安装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 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 sudo apt update sudo apt install bruno⚠️ 这个 APT 源目前只提供 amd64 架构ARM 机器比如一些 ARM 开发板直接选 Snap 或 Flatpak 更稳。apt update报 404 的话多半就是架构不匹配换 Snap 即可。安装 CLI 工具 bru 并跑通第一个集合bru从 npm 全局安装源码在 packages/bruno-cli/主要用来批量执行集合和接 CInpm install -g usebruno/cli装好后进入你的集合目录几个最常用的命令bru run # 跑整个集合 bru run --env Local # 指定环境跑 bru run request.bru # 只跑单个请求.bru和 OpenCollection.yml两种格式的请求在桌面端、CLI、VSCode 插件里行为一致集合换机器就能用⚠️ 装完提示找不到bru命令时先确认 Node.js 在 18 以上然后重装npm uninstall -g usebruno/cli npm install -g usebruno/cli验证安装结果与常见报错处理验证就三步桌面版打开应用随便建一个 GET 请求发出去能收到响应说明网络、代理都没问题。CLI在集合目录执行bru run request.bru终端应输出状态码和断言结果。顺手看下版本确认装的是预期分支。遇到这两类问题按顺序排查桌面版装完启动失败核对系统版本是否达标 → 重跑一遍安装命令 → 翻应用日志找具体报错。bru命令不工作检查 Node.js 版本与 npm 全局路径是否在PATH里 → 按上一节的方法重装。装完之后做什么Bruno 集合本来就是普通文件夹直接交给 Git 管理即可。请求文件以纯文本 diff 的方式进代码评审改一个 URL 一目了然两个具体方向二选一就可以动手把集合目录git init提交到仓库团队评审.bru文件的每次变更给集合配上环境文件用bru run --env CI做回归断言。CI 里接测试管线的思路可以参考仓库内的 docs/playwright-testing-guide.md。官方中文文档docs/readme/readme_cn.md【免费下载链接】brunoOpensource IDE For Exploring and Testing APIs (lightweight alternative to Postman/Insomnia)项目地址: https://gitcode.com/GitHub_Trending/br/bruno创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
