企业官网建设流程全解析

Bruno 安装教程：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 文件，没有云同步，也不要求注册账号。这篇 Bruno 安装指南给出各系统推荐的一行安装命令、验证方式和 bru 命令行速查，新手照着走，大约 15 分钟能跑通第一个请求。

文件夹 + 纯文本：Bruno 的核心设计

装之前先搞清楚 Bruno 存东西的方式，很多安装后的困惑都跟这有关。

Postman 把请求存在云端账号里，Bruno 把它们存在你的磁盘上：一个集合就是一个文件夹，每个请求是一个 .bru 文件，长这样：

method GET url https://httpbin.org/get

这就是全部结构——纯文本、可读、可 diff，VS Code 直接打开也能改。

📦 集合文件夹里除了请求，还可以放环境变量文件。因为都是文本，git init之后整个文件夹就能进版本库，队友 pull 下来即可使用，评审请求改动和评审代码没有区别。

Bruno 安装：各系统推荐的一行命令

Windows 10 及以上、macOS 10.15 及以上、主流 Linux 发行版都开箱即用。每个系统选一条推荐路径执行即可，备选渠道放在文末表格里。

macOS：用 Homebrew 安装 Bruno

brew install bruno

一条命令装好官方构建。⚠️ 如果提示brew: command not found，说明 Homebrew 本身还没装，先安装 Homebrew 再回来执行这一行。

Windows：用 Winget 安装 Bruno

winget install Bruno.Bruno

winget 较新的 Windows 自带，装完在开始菜单搜 “Bruno” 启动。⚠️ 找不到winget时，先把 Windows 10 的 Microsoft Store 更新到最新版。

Linux：用 Snap 安装 Bruno

snap install bruno

Ubuntu 等发行版默认带 snapd，直接可用。⚠️ 如果snap不存在，说明发行版没装 snapd，可换用flatpak install com.usebruno.Bruno；官方 Apt 源的配置步骤较长，命令在仓库的 docs/readme/readme_cn.md 里。

各系统的备选渠道，按需取用：

Bruno 安装完成后：打开并发出第一个请求

1. 启动 Bruno（Windows 开始菜单 / macOS Launchpad / Linux 应用菜单搜 “Bruno”）。
2. 新建集合，指向一个本地空文件夹，比如~/api-demo。
3. 在集合里点 “+” 新建请求：方法选 GET，地址填https://httpbin.org/get。
4. 点 Send，响应出现在下方面板里。

如果新建集合后左侧是空的，属于正常现象——文件夹里还没有请求，先按第 3 步建一个。请求发不出去时，先检查 URL 是否完整、网络能否直接访问该地址。

用 bru 批量跑集合（顺手接入 CI）

图形界面之外的另一半是命令行。集合还是刚才那个文件夹，bru可以在终端里把里面的请求按顺序全部执行，退出码直接反映通过与否，CI 流水线拿来即用。

npm install -g @usebruno/cli

全局安装 bru 命令，需要本机有 Node.js。⚠️ 装完提示bru: command not found，一般是 npm 全局目录不在 PATH 里，执行npm config get prefix看安装位置再补环境变量。

bru --version

✅ 能打印版本号，说明 CLI 就绪。

bru run

在集合目录下执行，会顺序跑完所有请求。

bru run request.bru

只想跑单个文件就传文件名；后面加--env Local可以切换环境。不想在机器上装 Node 的话，官方提供了 Docker 镜像，说明在 packages/bruno-cli/docker/。

卡住时看哪里

• 官方中文文档：docs/readme/readme_cn.md
• CLI 全部选项与退出码表：packages/bruno-cli/
• .bru 文件格式示例：packages/bruno-lang/

文中命令后的提示已覆盖最常见的报错。再往下卡住，多半是网络或权限问题，先对照这三处资料排查，比盲目重装有效。

图形界面和 CLI 读的是同一批文件：在 Bruno 里改的请求，终端里立刻就能跑。习惯这个节奏之后，回头看云端集合反而觉得别扭。

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