Bruno API 调试：装完 5 分钟发出你的第一个请求

Bruno API 调试：装完 5 分钟发出你的第一个请求

【免费下载链接】brunoOpensource IDE For Exploring and Testing API's (lightweight alternative to Postman/Insomnia)项目地址: https://gitcode.com/GitHub_Trending/br/bruno

Bruno 是一款开源 API 客户端，集合直接存在本地文件夹里，请求用纯文本 .bru 文件书写，全程离线。装完你就能发出第一个 API 请求、用命令行批量跑整个集合，全程约 5 分钟。

一分钟看懂它的设计取舍

• 集合就是一个文件夹，请求是纯文本 .bru，编辑器里就能看、能改、能 diff
• 完全离线，没有云同步，数据只留在你自己的设备上
• 配合任意版本控制协作，Git 是官方推荐方式

30 秒做个环境体检

• Windows 10+ / macOS 10.15+ / Linux（Ubuntu 18.04+）
• 装 CLI 需要 Node.js，只装图形界面则无依赖
• 手里有 Postman 或 OpenAPI 集合？装完可直接导入，不用手写

每个系统挑一条命令装好

macOS——这条通过 Homebrew 安装 Bruno 应用：

brew install bruno

Windows——这条用 Chocolatey 安装，没有 Choco 的话改用scoop install bruno或winget install Bruno.Bruno：

choco install bruno

Linux——有 snap 时这条最短，一条装完：

snap install bruno

没有 snap 的 Debian/Ubuntu 走官方 apt 源（需要添加 GPG 公钥，步骤见 readme.md 的 Installation 一节）。

确认版本没装歪

1. 打开 Bruno 新建集合，写一条GET https://example.com请求并发送，收到 200 响应即成功
2. 装了 CLI 的话，在终端跑bru --version，能打印版本号说明命令链没问题

装完之后还能干嘛

• 用 CLI 批量跑集合、接入 CI：npm install -g @usebruno/cli，然后在集合目录执行bru run，完整说明在 packages/bruno-cli/
• 用 Git 管理集合：文件夹即集合，git add . && git commit就能把 API 调试资产纳入版本库
• 导入存量集合：应用内 Import 支持 OpenAPI、Postman 等格式，CLI 侧对应bru import openapi

卡住了看这里

• bru命令找不到→ Node.js 没装或全局 bin 不在 PATH → 先node -v确认，装好 Node 后重新npm install -g @usebruno/cli
• Linux 装完打不开→ 桌面系统版本低于 Ubuntu 18.04 → 改用 snap 版或升级系统
• 导入 Postman 集合失败→ 导出格式过旧 → 在 Postman 里重新以 v2.1 格式导出再导入

下一步读 docs/readme/readme_cn.md 了解 .bru 语法与完整功能；确认是缺陷就按 contributing.md 去提 Issue。

【免费下载链接】brunoOpensource IDE For Exploring and Testing API's (lightweight alternative to Postman/Insomnia)项目地址: https://gitcode.com/GitHub_Trending/br/bruno