告别复杂！Bruno图形界面3分钟上手指南

作为Postman/Insomnia的轻量级替代方案，Bruno以开源免费、本地文件存储和简洁界面著称。本文将带你快速掌握其图形界面核心功能，让API测试效率提升300%。读完你将学会：创建API集合、配置多环境变量、编写测试脚本、团队协作版本控制等实用技能。

界面概览：简洁而不简单

Bruno采用三栏式布局设计，左侧为集合导航，中间是请求编辑区，右侧为响应展示区，符合API开发人员的操作习惯。

主要功能区域包括：

• 集合管理区：以文件目录结构组织API请求，支持多级文件夹嵌套
• 请求编辑器：可视化配置HTTP方法、URL、 headers、参数和请求体
• 响应查看器：支持JSON、XML等多种格式的响应数据展示与格式化
• 环境管理：快速切换开发/测试/生产等多环境配置
• 脚本面板：前置/后置脚本编辑区，支持JavaScript语法

核心功能详解

1. 本地集合管理：Git友好的API项目

Bruno最独特的优势在于将API集合以纯文本文件存储在本地文件夹中，每个请求对应一个.bru文件，集合配置存储在bruno.json中。这种设计使API项目天然支持Git版本控制。

创建新集合的步骤：

1. 点击左上角"文件" > "新建集合"
2. 选择保存路径并命名集合
3. 集合文件夹结构自动生成：

my-api-collection/
├── bruno.json       # 集合配置
├── environments/    # 环境变量文件
│   ├── dev.bru
│   └── prod.bru
└── requests/        # API请求文件
    ├── get-users.bru
    └── create-user.bru

2. 多环境配置：一套请求适配多环境

Bruno支持全局环境与集合级环境变量，通过{{variable}}语法实现请求中的参数插值。

环境变量使用技巧：

• 全局环境：适用于所有集合的通用变量，如认证令牌
• 集合环境：特定项目的环境配置，如API基础URL
• 支持嵌套JSON结构：{{user.address.city}}
• 多环境快速切换：通过顶部环境下拉菜单一键切换

3. 可视化请求构建：无需手动编写JSON

请求编辑器提供丰富的表单控件，可视化配置各种请求参数：

支持的高级功能：

• 自动补全：URL、headers和参数的智能提示
• 语法高亮：请求体JSON/XML的语法检查
• 文件上传：表单数据模式下支持文件选择
• GraphQL支持：专用GraphQL请求编辑器，带语法高亮

4. 脚本自动化：前置/后置处理逻辑

Bruno内置JavaScript运行时，可编写前置脚本(请求发送前)和后置脚本(响应接收后)：

// 前置脚本示例：生成动态签名
const timestamp = Date.now();
const signature = md5(apiKey + timestamp + secret);
bruno.setEnvVar("timestamp", timestamp, { persist: true });
bruno.setEnvVar("signature", signature, { persist: true });

后置脚本可进行响应验证：

// 验证响应状态码
bruno.test("响应状态码应为200", () => {
  bruno.expect(response.status).toBe(200);
});

// 验证响应体结构
bruno.test("用户ID应存在", () => {
  bruno.expect(response.json().data.id).toBeDefined();
});

脚本执行环境提供的核心API在bruno-js/src/bruno-request.js中定义。

5. CLI工具集成：命令行运行API测试

除了图形界面，Bruno还提供命令行工具，支持CI/CD流程集成：

基本用法：

# 安装CLI
npm install -g @usebruno/cli

# 运行集合测试
bruno run ./my-api-collection --env dev --output json > report.json

CLI详细文档可参考packages/bruno-cli/readme.md。

扩展与集成

VS Code插件：编辑器内直接编辑

Bruno提供VS Code插件，支持在编辑器中直接打开和编辑.bru文件，实现API开发与代码编写的无缝衔接。

插件功能：

• .bru文件语法高亮
• 代码片段快速生成
• 右键菜单直接运行请求
• 响应结果在编辑器内展示

数据导入：无缝迁移现有API项目

支持从主流API工具导入数据：

• Postman collections (v2.0/v2.1)
• Insomnia exports
• OpenAPI/Swagger规范
• HAR文件

导入功能实现代码位于packages/bruno-converters/src/workers/。

开始使用Bruno

安装指南

Bruno提供多种安装方式，适用于不同操作系统：

# MacOS (Homebrew)
brew install bruno

# Windows (Chocolatey)
choco install bruno

# Linux (Snap)
snap install bruno

完整安装说明参见docs/readme/readme_cn.md。

学习资源

• 官方文档：docs/
• 示例集合：packages/bruno-cli/examples/
• 贡献指南：docs/contributing/contributing_cn.md
• API测试脚本：tests/runner/

总结

Bruno通过创新的本地文件存储方案、简洁直观的界面设计和强大的脚本能力，为API开发测试提供了高效解决方案。其开源免费的特性和Git友好的设计特别适合中小型团队和个人开发者使用。

无论是API探索、自动化测试还是团队协作，Bruno都能满足现代API开发的需求，同时避免了传统API工具的复杂性和订阅费用负担。

立即访问Bruno仓库获取最新版本，开始您的高效API开发之旅！