受公司数据安全政策影响，我不得不由Postman转向了开源API测试工具Bruno。文章详细介绍了Bruno的下载安装、Workspace和Collection管理、请求配置、变量与环境变量使用、Git集成及测试能力等核心功能，并通过丰富截图与操作说明，展示了Bruno的易用性和灵活性。对于日常API测试需求，Bruno已能满足大部分开发者的使用场景。

1. 初识 Bruno

Postman一直是我进行API测试使用的工具，今天收到单位内部信，由于数据安全的原因不可以使用免费版的Postman了。如果非要使用Postman，只能使用企业付费版的。正常价是900多刀一年，企业内部的license要是用的多的话，会便宜一些。大环境不好的情况，就别申请付费版了。

内部推荐的替代是Bruno，一直伸着舌头的小黄狗。它是一个开源的，本地的，轻量级的API客户端。当然了，除了社区版，它也有付费版叫Bruno Ultimate。

• 客户端下载：Bruno客户端
• Github项目地址：Bruno
• 项目文档：Bruno Docs

截至 2026 年 1 月，Bruno 已成为开发者社区中备受推崇的 API 测试工具，被视为 Postman 的强力开源替代方案。

2. 基本操作

2.1 创建 Workspace

Workspace分为默认的My Workspace和自定义Workspace。首次打开Bruno后会自动创建默认Workspace，它无法被关闭和删除。而自定义的Workspace支持Git，分享以及管理collections。

创建自定义Workspace。

2.2 创建 Collection

创建Collection时，支持两种文档格式 .bru 和 .yaml(beta)。Bruno的维护者说Json不支持多行字符串，YAML的缩进让人头疼，因为发明了叫做Bru的标记语言。当然了，看了一下是使用了ohmjs库把.bru翻译成Json。我就姑且使用它推荐的格式。

也在可以在Collection下再创建文件夹，把同类型的请求放在一个文件夹下面，并支持共用的一些参数。

2.3 软件设置

客户端的左下角有Theme的选项，可以选择Light和Dark或是跟随系统。

其余的设置在左下角的小齿轮里，但是设置选项并没有太多。

3. Request

3.1 创建 Request

Request可以在Collection或是文件夹层面创建。每一级的名称右面都有三个小点，可以点击new request。在这里需要指定Request的类型，我选的是HTTP，因为我后端是FastAPI。然后再指定API的URL以及HTTP方法。

3.2 Request 下的选项

以登陆的API作为例子来看一下各个选项。

Params

在参数这里面，并没有区别是路径参数还是查询参数。它的机制是，根据参数名字来判断，如果API的路径参数里的名字能对上就是路径参数，对不上就是查询参数。

Body

因为我要提交的是登录表单，所以选择URL encoded。Body里是username和password。

Header

没有要往Header加的东西，没有特殊的Header，也没有Token，因为是Login。

Auth

No Auth因为现在是要取得access token。但是以下的验证方式。

File

Request的参数都设置完后，点击file会显示出文件里的内容，它和存在磁盘上的文件是一样的。这个格式就是.bru的格式。

3.3 运行 Request

发送Request，然后收到的Response会在客户端的右侧显示。显示的方式是最常用的JSON，当然也有其他的方式，譬如HTML，XML，RAW等。

这是Response的Body。

这是Response的Header。

在Timeline这可以查看调用这个API的历史。点开每条历史，里面会保存Request，Response和Network Logs的数据。也可以点击右上角清除历史。

4. Variable 变量

4.1 普通变量

在右上角新建变量，我是按Collection来的。毕竟每个Collection测试的大概率不是同一个API Server。

变量就是键值对，对于密码或是API Key之类的可以点击Secret的开关，这样显示就是隐藏的了。

也可以在文件夹级别设置变量，它的优先级高于Collection。

如果同一个变量名在Collection和文件夹下都设置了。则在文件夹内的文件走文件夹的变量设置，Collection内的其它文件则遵循Collection的变量。变量的写法是{{ VAR NAME }}。

4.2 环境变量

在Collection的文件夹下新建一个 .env 文件，把baseUrl从Collection的变量移到环境变量里，内容为 baseUrl = http://127.0.0.1:8000/api/v1。这时可以看见原来的变量名变红了，说明它失效了。

.env文件要放在Collection名字的根目录下面。

然后在这个Collection设置变量的时候，键值对的值可以使用环境变量的键，只不过变量的名字前面加上前缀process.env.。

但是在实际使用变量的时候，还是使用原来的变量名，发送Request依然可以得到Response。这个只是一个例子，通常是将敏感信息放到环境变量里，譬如账号密码，Token，API Key，私钥等。

4.3 环境变量存JWT来访问受限API

在Collection的变量里将值设为环境变量的键，然后在Request的时候引用。正常认证的信息是在请求的头部的，在客户端是单独列出来了一个Auth的选项。

5. Git

Bruno引以为傲的就是本地优先且项目即文件，因此使用Git进行版本管理也是顺理成章的了。客户端自带Git的UI界面，然而连Commit都需要付费版。我们直接在这个文件夹下面使用Git CLI进行操作就好了，对于用户来说没啥大的区别。

6. 测试能力

可以使用JS写一些用于测试的东西。这部分我从官网找的例子。

6.1 Assert

可以对多种参数进行断言，譬如Response的状态码，返回值啥的。格式就是目标，操作符和值。

6.2 Script

在Request之前或是Response之后，对一些参数进行操作。

6.3 Tests

和断言类似，也是使用JS写一些复杂的逻辑来判断一些事情。

7. 结尾

这篇文章省去了很多的介绍部分，着重讲了Bruno的用法，基本上算是一个比较全面的使用文档了。经过了一天的研究，对于我这种比较简单的API测试，还是可以平替Postman的。我也不需要登录，文件都在本地，通过Git也可以很好的分享给其他人。但是说回来，使用Postman的时候我还是觉得挺舒心的，毕竟用的比较习惯了。如果不是公司政策的要求，我也不会换其它的工具。