企业官网建设流程全解析

3分钟装好Bruno并发出第一个API请求：Windows/macOS/Linux完整走通

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

Bruno 是一款开源、本地优先的 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 安装到用户目录，不需要管理员。

安装：各平台最快路径，一条命令

Windows

首选系统自带的 winget：

winget install Bruno.Bruno

团队统一用 Chocolatey 或 Scoop 的话：

choco install bruno

scoop bucket add extras scoop install bruno

macOS

brew install bruno

不用 Homebrew 也可以：从官网下载 DMG，双击打开后把 Bruno 拖进应用程序文件夹，效果一样。

Linux

Ubuntu 上最快是 Snap：

snap install bruno

或者 Flatpak：

flatpak install com.usebruno.Bruno

Ubuntu/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?op=get&search=0x9FA6017ECABE0266" \ | gpg --dearmor \ | sudo tee /etc/apt/keyrings/bruno.gpg > /dev/null sudo chmod 644 /etc/apt/keyrings/bruno.gpg echo "deb [arch=amd64 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

Arch 用户可以走 AUR：

yay -S bruno

首次启动验证：三步确认装好了

第一步：启动应用。开始菜单或应用程序列表里找到 Bruno，首次打开显示欢迎页，左下角能看到版本号——能启动是第一道关。

第二步：写第一个请求。新建一个目录，里面放一个first-request.bru：

mkdir -p ~/my-api

文件内容如下（纯文本，保存为first-request.bru）：

meta { 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.js：

npm 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/bruno

PR 评审时的效果长这样，新增一个请求就是一个可读的文本 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 API's (lightweight alternative to Postman/Insomnia)项目地址: https://gitcode.com/GitHub_Trending/br/bruno