3分钟装好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 测试客户端请求以 .bru 纯文本文件存放在你硬盘的一个文件夹里不用注册账号、不做云同步天然适合用 Git 做团队协作。目标很直接——你在 Windows、macOS 或 Linux 上把 Bruno 装好并让它把第一个 200 响应返回给你。如果你习惯了先登录再建集合的工作流这里是根本区别集合就是一个目录git push 之后整个团队看到的就是同一份 API 测试。完整功能介绍可以看官方中文文档。环境预检装之前确认三件事系统版本Windows 10 及以上、macOS 10.15 及以上、Ubuntu 18.04 或 Debian 10包管理器看你手上有什么——Windows 的 winget/scoop/Chocolatey、macOS 的 Homebrew、Linux 的 snap/flatpak/apt。安装章节按最快路径优先组织缺哪个装哪个Node.js只有后面用 CLI 章节时才需要现在可以不管预检一分钟以内能完成。如果你在公司 Windows 机器上没有管理员权限直接走安装章节的 Scoop 路径——Scoop 安装到用户目录不需要管理员。安装各平台最快路径一条命令平台推荐方式一条命令Windowswingetwinget install Bruno.BrunomacOSHomebrewbrew install brunoLinuxSnapsnap install brunoWindows首选系统自带的 wingetwinget install Bruno.Bruno团队统一用 Chocolatey 或 Scoop 的话choco install brunoscoop bucket add extras scoop install brunomacOSbrew install bruno不用 Homebrew 也可以从官网下载 DMG双击打开后把 Bruno 拖进应用程序文件夹效果一样。LinuxUbuntu 上最快是 Snapsnap install bruno或者 Flatpakflatpak install com.usebruno.BrunoUbuntu/Debian 长期使用的推荐官方 apt 源签名包、apt upgrade 即可升级。⚠️ 注意该源只提供 amd64 架构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 brunoArch 用户可以走 AURyay -S bruno首次启动验证三步确认装好了第一步启动应用。开始菜单或应用程序列表里找到 Bruno首次打开显示欢迎页左下角能看到版本号——能启动是第一道关。第二步写第一个请求。新建一个目录里面放一个first-request.brumkdir -p ~/my-api文件内容如下纯文本保存为first-request.brumeta { name: First request type: http } get { url: https://jsonplaceholder.typicode.com/todos/1 }第三步发送并看响应。用 Bruno 打开这个目录作为集合点击请求的发送按钮。状态码 200、响应面板出现 JSON这次 API 测试安装就算跑通了。第三种验证手段后面装完 CLI 后执行bru --version能打印版本号说明命令行链路也是好的。CLI一条命令跑整个集合GUI 适合开发调试CI 流水线里用的是bru。安装需要先有 Node.jsnpm install -g usebruno/cli bru --version常用命令bru run bru run first-request.bru bru run auth --env Local结果可以输出成 JSON 报告bru run --output results.json直接接进 CI还能把 OpenAPI 规范导入成集合bru import openapi。完整命令参考在源码里都有见 packages/bruno-cli/。版本控制集合就是文件夹Git 原生存活对 Bruno 集合目录执行cd ~/my-api git init git add . git commit -m first request git push -u origin main.br 文件是纯文本PR 里的 diff 人眼可读代码评审流程原样照搬。想直接看一个可用的样例集合clone 源码仓库打开packages/bruno-tests/collection/就能在 Bruno 里加载git clone https://gitcode.com/GitHub_Trending/br/brunoPR 评审时的效果长这样新增一个请求就是一个可读的文本 diff常见卡点三个原因与解法choco install bruno 提示找不到包原因Chocolatey 默认源同步有延迟或者你挂在的镜像站没有同步 bruno 这个包。解法先执行choco source update再重试仍找不到就换winget install Bruno.Bruno两者装到的是同一个应用。bru: command not found原因Node.js 没装好或 npm 全局 bin 目录不在 PATH 里nvm 和 Linux 多用户环境最常见。解法npm config get prefix查看前缀路径把它下的bin目录加进 PATH重开终端再试还不行就npm install -g usebruno/cli --force重装一次。sudo apt update 报 404原因官方 apt 源只发布 amd64 架构的包arm64 机器如树莓派架构不匹配拉不到索引。解法dpkg --print-architecture确认架构不是 amd64 就放弃 apt改走snap install bruno或 Flatpak 路径。打开终端把你平台那行命令贴进去三分钟后你会看到那个 200 响应。装完想提 bug 或加功能从贡献指南开始就行。【免费下载链接】brunoOpensource IDE For Exploring and Testing APIs (lightweight alternative to Postman/Insomnia)项目地址: https://gitcode.com/GitHub_Trending/br/bruno创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考