10分钟跨平台安装BrunoWindows、macOS、Linux的完整安装与验证清单【免费下载链接】brunoOpensource IDE For Exploring and Testing APIs (lightweight alternative to Postman/Insomnia)项目地址: https://gitcode.com/GitHub_Trending/br/bruno换台电脑又要从头折腾API工具Bruno 是一款开源的 API 客户端这份清单覆盖它的跨平台安装全流程。读完你能带走三样东西三条可执行的安装路径、一套由轻到重的验证步骤以及两个最常见的卡壳问题怎么解。先搞懂它是什么Bruno 是一个跨平台的开源 API 客户端可以看作 Postman/Insomnia 的轻量替代。它最大的不同点在于你的 API 集合不是存在云端而是以纯文本.bru文件的形式放在本地文件系统的一个文件夹里全程离线可用不需要任何云账号。想和同事协作时把这个文件夹直接交给 Git 即可。同一份集合在 Desktop、CLI、VSCode 三种形态下都能跑不折腾。细节可以看官方文档docs/readme/readme_cn.md。装之前花10秒确认安装前把下面几项过一遍基本就不会在装的过程中返工✅ 系统版本达标Windows 10 及以上 / macOS 10.15 及以上 / Ubuntu 18.04 或 Debian 10✅ 如果要用命令行工具bru本机装有 Node.js终端跑node -v能出版本号即可✅ 如果打算从源码构建需要 Node v22.x 或最新 LTS 版本贡献模式的要求三种装法挑一种就行三条路径按推荐度从高到低排列包管理器一键装适合绝大多数人官方安装包适合不想碰命令行的场景源码构建适合想顺手看项目内部的人。路径一包管理器一键装推荐这是最省事的方式一条命令的事。下面按平台列出任选你系统对应的命令执行即可# Windows三选一 choco install bruno scoop bucket add extras scoop install bruno winget install Bruno.Bruno # macOS brew install bruno # Linux二选一 snap install bruno flatpak install com.usebruno.Bruno执行成功的标志终端滚动完依赖安装日志后无报错退出Windows 上开始菜单能搜到 BrunomacOS 的「应用程序」里出现 Bruno 图标Linux 的桌面应用列表里多出 Bruno 一项。路径二官方渠道装最稳macOS从 Bruno 官网下载 DMG 安装包双击打开后把 Bruno 拖进「应用程序」文件夹与拖一个 App 进「访达」的操作完全一样。Linuxapt 源如果你的发行版不在 snap/flatpak 覆盖范围内可以添加官方 apt 源。下面这段命令依次完成写入 GPG 密钥、添加 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 被成功安装Setting up bruno之类字样且无E:开头的报错。路径三源码构建最动手只有一种情况建议走这条路你想边装边看项目怎么跑起来。先克隆仓库再按仓库根目录的说明装依赖git clone https://gitcode.com/GitHub_Trending/br/bruno cd bruno npm i --legacy-peer-deps成功的标志npm i跑完无ERR报错node_modules和各子包目录就绪。后续启动方式见贡献指南contributing.md。装完别急着关终端装完不代表能用按顺序做这三个动作由轻到重看版本号终端输入bruno --version能看到具体版本号而不是command not found即通过。启动应用执行bruno或从开始菜单/应用程序文件夹启动主界面能完整渲染出集合侧边栏即通过。发一个最简请求新建一个指向公开回显接口的 GET 请求并发送右侧响应面板返回 200 状态码即通过。三步全过才算装好任何一步卡住都跳到下一节。顺手接入你的工作流 两件事各花一分钟之后会持续省事命令行跑集合。Bruno 附带 CLI 工具bru价值在于同样的集合不用打开界面就能批量执行适合塞进 CI 流程。用 npm 装一下然后进你的集合目录跑bru run终端会逐个列出请求结果和断言通过情况npm install -g usebruno/cliCLI 的完整实现可以看源码packages/bruno-cli/。用 Git 管理集合。因为集合本来就是纯文本文件夹协作不需要任何额外配置把集合目录加入仓库改动走普通的提交、合并流程同事拉下来直接打开就能用。卡住了看这里⚠️ 两个高频问题都按「先查什么 → 再做什么」来排查装完无法启动。先查对照前面「装之前花10秒确认」的清单确认系统版本真的达标很多人是旧版 Windows 或过老的 macOS再做什么卸载后重装仍然起不来就看应用日志文件定位具体报错。bru命令不认得。先查跑node -v确认 Node.js 环境本身正常再确认 npm 全局 bin 目录在 PATH 里再做什么把 CLI 卸掉重装一次多数情况就恢复了npm uninstall -g usebruno/cli npm install -g usebruno/cli结语装好了就别让它吃灰建一个新集合把你最常用那个接口存进去再提交到 Git。下次换机器clone 下来就又是一套现成的工作台。【免费下载链接】brunoOpensource IDE For Exploring and Testing APIs (lightweight alternative to Postman/Insomnia)项目地址: https://gitcode.com/GitHub_Trending/br/bruno创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
