Bruno API客户端新手完整安装指南Windows / macOS / Linux 三平台快速上手【免费下载链接】brunoOpensource IDE For Exploring and Testing APIs (lightweight alternative to Postman/Insomnia)项目地址: https://gitcode.com/GitHub_Trending/br/brunoBruno 安装不需要折腾。作为一款开源 API 客户端Bruno 把你的 API 请求直接存成本地文本文件靠 Git 与同事原生协作并且完全离线运行不需要任何云端账号。这篇指南带你把 Bruno 装进 Windows、macOS 和 Linux并验证第一个请求。安装前30秒自查平台最低系统版本WindowsWindows 10 及以上macOSmacOS 10.15 及以上LinuxUbuntu 18.04 / Debian 10选装方式的规律很简单想一行命令装好、以后也一行命令更新就用包管理器Winget、Homebrew、Snap 这类完全不想碰命令行就直接用安装包macOS 的 DMG 之类。 三平台安装最短路径先看对照表按你所在的平台挑一条推荐路线平台首选方式一行命令WindowsWinget系统自带winget install Bruno.BrunomacOSHomebrewbrew install brunoLinuxSnapsnap install bruno在 Windows 安装 Brunowinget install brunoWinget 自带于较新的 Windows 10 与 Windows 11无需额外安装。打开 PowerShell 执行winget install Bruno.BrunoWinget 会自动下载并完成安装预期结果是开始菜单里能找到并启动「Bruno」。如果你更习惯 Chocolatey直接执行choco install bruno如果你更习惯 Scoop先加 extras 桶再安装scoop bucket add extras scoop install bruno两条路线的预期结果一致开始菜单里出现 Bruno点开即可。在 macOS 一行命令装好 Brunobrew install brunomacOS 上用 Homebrew 装 Bruno 只要一行brew install bruno执行完从聚焦搜索或「应用程序」文件夹启动预期结果是主窗口正常打开。如果你更喜欢图形化安装到官网下载页拿 macOS 版 DMG双击后把 Bruno 拖进应用程序文件夹全程不碰命令行。在 Linux 安装 Brunosnap install bruno装有 snapd 的 Ubuntu / Debian 上Snap 是最短路径snap install bruno命令会自动下载 Bruno 包预期结果是应用菜单里出现「Bruno」点开就能运行。如果你更习惯 Flatpak同样一行flatpak install com.usebruno.Bruno完成后从应用菜单正常启动 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 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预期结果同样是应用菜单里出现 Bruno。✅ 首次启动与安装验证打开 Bruno 后按顺序做三件事就能确认安装没有问题双击桌面图标或从开始菜单启动看到左侧是集合列表的主窗口。看窗口右下角的版本号确认和你刚装的版本一致。新建一个 GET 请求URL 填https://echo.usebruno.com点发送右侧出现 200 OK 和一段 JSON说明安装链路完整可用。⌨️ 命令行模式bru不想打开图形界面也能跑集合Bruno 提供了 bru 命令行工具。机器上有 Node.js 的话用 npm 全局安装npm install -g usebruno/cli装完执行bru --version确认版本。然后进入你的集合目录直接运行bru run它会按顺序跑完当前集合里的所有请求。指定环境或导出结果时加上对应参数bru run folder --env Local --output results.json最常见的场景是接入 CI在流水线里执行bru run api-tests --env staging --reporter-junit report.xml任何一条断言失败退出码就是 1流水线直接标红。CLI 源码可以翻 packages/bruno-cli/ 看。集合与Git协作这是 Bruno 和 Postman 类产品最大的不同一个集合就是磁盘上一个普通文件夹请求存成 .bru 文本文件。所以 Git 协作天然可用不需要插件也不需要云同步。最小工作流就是三条命令git init git add my-collection git commit -m add my api collection之后把集合推到任意远程仓库同事克隆下来用 Bruno 打开就能接手。不同人改动的请求在拉取请求里就是可读的文本 diff 排障速查现象可能原因解决办法安装后 Bruno 无法启动系统版本低于自查表要求或安装未完成确认操作系统达到最低版本仍不行就卸载重装bru命令无法识别Node.js 未装或 npm 全局路径不在 PATH 里先跑node -v、npm -v确认环境再重装npm install -g usebruno/clibru run报退出码 4没有在集合根目录执行cd到含bruno.json的集合文件夹里再运行brew install bruno找不到包或卡住不在 macOS 环境或 Homebrew 版本过旧先升级 Homebrew嫌麻烦就换 DMG 安装包下一步导入一个已有的 Postman / OpenAPI 集合体会「文件夹式」和「云端式」管理的差别装上 bru把集合接进 CI让每次提交都自动跑一遍通读中文文档熟悉环境变量、请求变量与请求脚本官方文档中文docs/readme/readme_cn.md 贡献指南contributing.md【免费下载链接】brunoOpensource IDE For Exploring and Testing APIs (lightweight alternative to Postman/Insomnia)项目地址: https://gitcode.com/GitHub_Trending/br/bruno创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考