Bruno 安装教程：3 种方法装好这款开源 API 测试工具，新手 3 分钟跑通
【免费下载链接】brunoOpensource IDE For Exploring and Testing API's (lightweight alternative to Postman/Insomnia)项目地址: https://gitcode.com/GitHub_Trending/br/bruno
Bruno 是一款开源的轻量级 API 客户端（IDE），定位是 Postman / Insomnia 的替代品：它把你的 API 请求集合直接存成本地文件夹里的纯文本.bru文件，可以离线使用，也天然支持 Git 协作。适合需要管理接口、写自动化测试、又希望数据留在自己电脑上的开发者。
下面这篇 Bruno 安装教程会带你走完「选路线 → 安装 → 验证 → 体验特色功能」全流程。
三种装法怎么选
先判断你的使用场景，再对号入座：
| 方法 | 适合谁 | 特点 |
|---|---|---|
| 包管理器一键装 | 已经用着 Homebrew / Chocolatey / Snap 等包管理器的人 | 一条命令，自动更新最省心 |
| 官方安装包 | 不想依赖包管理器、或公司电脑受管控 | 下载即用，无需命令行 |
| 只装 Bruno CLI | 想把集合跑进 CI/CD 或纯命令行工作流 | 不装图形界面，依赖 Node.js |
三种方法互不冲突：图形界面和 CLI 可以共存，且共享同一套集合文件夹。
方法一：包管理器一键装（推荐）
这是最快的一条路，每个系统都有现成方案，挑你熟悉的那条即可：
# macOS（Homebrew） brew install bruno # Windows（任选其一） choco install bruno winget install Bruno.Bruno # Linux（任选其一） snap install bruno flatpak install com.usebruno.BrunoArch 系用户可以直接yay -S bruno；Ubuntu / Debian 也可以走官方 Apt 源，只需先添加 Bruno 的 GPG 密钥和源地址，再执行sudo apt install bruno即可（源添加脚本见官方文档，不赘述）。
装完像普通应用一样从启动器里打开 Bruno 就行。
方法二：官方安装包
不想动包管理器就走这条：访问 Bruno 官网下载页，按你的系统选对应安装包——macOS 是 DMG（拖进「应用程序」文件夹即可）、Windows 是安装程序、Linux 提供 AppImage / deb 等格式。
这条路线对新手最直观：下载、安装、打开，三步。注意 Linux 下部分发行版首次运行若提示未签名应用，按系统提示允许一次即可。
方法三：只装 Bruno CLI（命令行 / CI 场景）
如果你的目标不是点界面，而是把整套 API 测试跑进自动化流程，那么可以只装 CLI，前提是本机有 Node.js 环境：
npm install -g @usebruno/cli然后进入你的集合目录，一条命令跑全部请求，或用--env指定环境：
bru run bru run folder --env LocalCLI 还能把 OpenAPI 规范直接导入成 Bruno 集合（bru import openapi），省去手工建请求。
装完立刻验证
三步确认它真的能用，全程不到一分钟：
- 打开 Bruno（或命令行执行
bru --version），能正常启动 / 打印版本号即安装成功。 - 新建一个集合，建一个请求，URL 填
https://httpbin.org/get，点 Send。 - 右侧能看到 200 响应和返回的 JSON，说明网络栈、代理设置都没问题。
走到第 3 步，你的 Bruno 安装就彻底跑通了。
加分项：集合就是 Git 仓库，协作零成本
Bruno 最能打的特色只讲这一个：因为集合就是一堆.bru纯文本文件，你直接在这个文件夹里git init就能把整套 API 文档纳入版本管理——谁改了哪个请求的断言、接口结构变更前后对比，git diff一眼看清，团队共享靠 push/pull，不靠云端同步。
这也是它和 Postman 最本质的区别：数据在你硬盘上，格式是人可读的文本，换工具、迁移成本都极低。
避坑清单
- Windows 下
winget找不到 Bruno：更新一下 winget 源，或改用 Chocolatey 安装。 - CLI 装完没有
bru命令：多半是 npm 全局 bin 目录不在 PATH 里，执行npm bin -g查看路径并加入 PATH。 - Linux 首启报安全拦截：属发行版的未签名应用策略，按提示放行一次，后续不再出现。
- 请求发不出去但浏览器正常：检查系统代理，Bruno 会读取系统代理设置；公司内网需要走代理时留意一下。
- 集合打不开或目录是空的：Bruno 集合要求文件夹内含
.bru/ 配置等合法结构，导入后建议先用官方示例集合试跑。
下一步
图形界面 + CLI 都装好之后，建议先拿一个现成 API（如 httpbin）建一个小集合并提交到 Git，感受完整的「本地文件夹 + 版本控制」工作流。更多功能细节可以看仓库里的中文说明文档 docs/readme/readme_cn.md，CLI 用法参考 packages/bruno-cli/readme.md；想参与开发可以读一下 contributing.md。
【免费下载链接】brunoOpensource IDE For Exploring and Testing API's (lightweight alternative to Postman/Insomnia)项目地址: https://gitcode.com/GitHub_Trending/br/bruno
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
