Bruno安装快速指南3步在Windows、macOS、Linux完成API客户端部署【免费下载链接】brunoOpensource IDE For Exploring and Testing APIs (lightweight alternative to Postman/Insomnia)项目地址: https://gitcode.com/GitHub_Trending/br/bruno本指南面向需要离线使用、便于 Git 协作的 API 测试工具的开发者讲解 Bruno 在 Windows、macOS、Linux 三个系统的完整安装流程装完用两条命令验证可用。预计耗时 5 分钟左右。Bruno 定位API 请求就是本地纯文本文件Bruno 是一款开源 API 客户端定位为 Postman、Insomnia 的轻量替代。它的核心差异在存储方式每个集合对应一个本地文件夹每个请求是一个.bru纯文本文件文件夹可直接提交到 Git 仓库diff、评审、回滚都走标准 Git 流程。全程离线运行请求数据不离开本机。安装前自查系统版本与 Node.js 环境先确认系统版本达到最低要求否则安装会直接失败系统最低要求WindowsWindows 10 及以上macOSmacOS 10.15 及以上LinuxUbuntu 18.04 或 Debian 10amd64bru CLI以上任一系统另需已安装 Node.js最快的自查方式Windows 执行winvermacOS 执行sw_versLinux 执行cat /etc/os-release。按系统选安装方式包管理器优先安装包兜底机器上已有包管理器的用一条命令装桌面版公司内网限制包管理器时再从官网下载安装包。Windowswinget install Bruno.Brunowinget 是 Win10/11 内置的包管理器直接拉取 Bruno 官方安装包无需额外配置。已用 Chocolatey 或 Scoop 的改用对应命令choco install brunoscoop bucket add extras scoop install brunomacOSbrew install brunoHomebrew 下载应用并注册到应用程序目录装完即可启动。备选下载 DMG 安装包双击后将 Bruno 拖入 Applications。Linux首选 Snap自带运行时依赖最不容易缺库snap install bruno备选 Flatpakflatpak install com.usebruno.Brunoapt 源方式Debian/Ubuntu需要四步拉取并保存签名密钥 → 写入官方源 → 更新索引 → 安装。前两步由下面这段命令完成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安装 bru 命令行CI 与批量执行用npm install -g usebruno/cli全局安装 usebruno/cli 包并注册bru命令是终端或 CI 里批量跑集合的前提。两步验证安装版本号 最小请求第一步查版本bruno --version bru --version能打印出版本号说明安装动作本身已完成。第二步发一次最小请求启动应用新建请求选 GET地址填https://httpbin.org/status/200发送。响应面板出现 200说明发送、接收、解析全链路可用。三大常见坑排查现象、原因、解决命令⚠️ 终端提示bru: command not found原因npm 全局 bin 目录不在 PATH 中或安装未生效。 解决执行npm config get prefix查看前缀路径把该路径下的bin目录加入 PATH仍报错则重装npm install -g usebruno/cli。⚠️ apt 提示找不到 bruno 包原因源未添加或索引过期。 解决重新执行上文添加源的两段命令再跑sudo apt update。⚠️ 桌面版启动即崩溃多见于 Linux现象点击图标无反应或闪退。 原因系统版本低于最低要求或运行库缺失。 解决cat /etc/os-release核对版本不达标则升级系统达标就改用snap install brunoSnap 渠道自带运行时依赖。下一步Git 协作与 bru 批量测试集合即文件夹git init后推到远端仓库即可协作。新增一个请求的提交会生成可读的.brudiffAPI 变更可以直接在 PR 里评审。在 CI 或终端里用 bru 执行整个集合并指定环境bru run --env Local中文文档docs/readme/readme_cn.mdCLI 源码与完整选项packages/bruno-cli/贡献指南contributing.md【免费下载链接】brunoOpensource IDE For Exploring and Testing APIs (lightweight alternative to Postman/Insomnia)项目地址: https://gitcode.com/GitHub_Trending/br/bruno创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考