告别API测试繁琐配置：Bruno全局环境变量管理新方案

你是否还在为API测试中频繁切换环境配置而烦恼？是否因不同环境下的变量冲突导致测试结果不一致？本文将详细介绍Bruno这款开源API测试工具中全局环境变量的管理方案，帮助你实现环境配置的高效管理与复用。读完本文后，你将掌握全局环境变量的创建、配置、高级使用技巧及最佳实践，彻底摆脱手动修改环境参数的繁琐流程。

全局环境变量基础概念

全局环境变量（Global Environment Variables）是Bruno中用于在不同集合（Collection）间共享的动态配置参数，可实现跨项目的环境一致性管理。与集合级环境变量仅作用于单个项目不同，全局环境变量适用于需要在多个API测试集合中复用的公共配置，如基础URL、认证令牌（Token）等。

Bruno将环境变量分为以下两类：

• 集合环境变量：仅作用于当前API测试集合，配置文件存储在集合目录内
• 全局环境变量：可在所有集合中共享，配置数据存储在用户偏好设置中

官方文档：docs/readme/readme_cn.md

全局环境变量配置步骤

创建全局环境

1. 打开Bruno应用，点击顶部导航栏的环境选择器（Environment Selector）
2. 在弹出的环境管理面板中，切换到全局环境（Global Environment）选项卡
3. 点击创建按钮，输入环境名称（如"Production"、"Staging"）
4. 点击保存完成基础环境创建

添加环境变量

1. 在全局环境配置界面，点击添加变量按钮
2. 在新行中输入变量名称和值，支持以下数据类型：
   • 字符串（String）：直接输入文本内容
   • 数字（Number）：如170001（无需引号）
   • 布尔值（Boolean）：true或false（无需引号）
3. 对于敏感信息（如API密钥），可勾选保密（Secret）选项隐藏值显示
4. 点击保存按钮应用配置

代码示例：tests/global-environments/non-string-values.spec.ts

环境切换与使用

1. 在集合编辑界面，通过顶部环境选择器切换不同全局环境
2. 在请求URL、 headers或请求体中，使用双大括号语法引用变量：

   {{baseUrl}}/api/users/{{userId}}
   

3. 发送请求时，Bruno会自动将变量替换为当前环境的实际值

高级功能与技巧

非字符串类型变量支持

Bruno全局环境变量支持数字、布尔等非字符串类型，通过脚本设置的非字符串变量会自动标记为只读，并在UI中显示特殊提示。

// 在请求后脚本（Post-Script）中设置数字类型变量
bruno.setEnvVar('numericVar', 170001, { persist: true, global: true });

// 设置布尔类型变量
bruno.setEnvVar('booleanVar', true, { persist: true, global: true });

当鼠标悬停在只读变量旁的信息图标上时，会显示提示："Non-string values set via scripts are read-only and can only be updated through scripts."

多行变量处理

对于JSON、XML等多行文本，Bruno提供专门的多行编辑器支持：

1. 在变量值输入框点击切换多行编辑按钮
2. 输入或粘贴多行文本内容
3. 保存后变量值会自动进行格式化处理

测试代码示例：tests/environments/multiline-variables/write-multiline-variable.spec.ts

环境变量导入导出

Bruno支持全局环境变量的批量导入导出，便于团队协作和环境迁移：

1. 在全局环境管理界面，点击导出按钮将当前配置保存为JSON文件
2. 在目标设备上，通过导入按钮加载保存的JSON配置文件
3. 导入时支持增量合并，避免覆盖现有配置

导入功能测试：tests/environments/import-environment/collection-env-import.spec.ts

最佳实践

环境变量命名规范

• 使用小写字母和下划线组合（如api_version）
• 为不同环境使用统一前缀（如prod_api_url、test_api_url）
• 敏感变量添加secret_前缀（如secret_access_token）

变量作用域管理原则

1. 最小权限原则：仅将必要变量设置为全局
2. 明确覆盖关系：集合环境变量会覆盖同名全局变量
3. 版本控制建议：集合环境变量文件应纳入Git版本控制，全局环境配置建议本地备份

敏感信息处理

对于API密钥、认证令牌等敏感信息：

1. 勾选变量的保密选项，Bruno会以星号（*）显示值
2. 避免将包含敏感信息的环境配置文件提交到代码仓库
3. 考虑使用环境变量注入工具（如dotenv）配合Bruno CLI使用

常见问题解决

变量未正确替换

若请求中变量未被正确替换，请检查：

1. 变量名称是否存在拼写错误
2. 当前是否选择了正确的全局环境
3. 变量引用语法是否正确（双大括号包裹）
4. 变量值是否包含特殊字符需要转义

非字符串变量编辑限制

通过脚本创建的非字符串变量在UI中为只读状态，如需修改：

1. 通过脚本重新赋值（推荐方式）
2. 删除变量后重新以字符串类型创建
3. 在变量配置界面使用"转换为字符串"功能

相关测试代码：tests/global-environments/non-string-values.spec.ts

总结

Bruno的全局环境变量管理功能为API测试提供了灵活高效的配置方案，通过本文介绍的方法，你可以实现环境配置的标准化、复用化和安全化管理。无论是个人开发者还是团队协作，合理使用全局环境变量都能显著提升API测试效率，减少环境相关的问题排查时间。

建议结合官方文档和测试用例进一步探索高级功能，如有疑问可通过Bruno的GitHub讨论区获取社区支持。

功能源码：packages/bruno-app/src/components/environments/ 社区教程：README.md