Bruno 全局环境变量完全指南：一次配置，所有集合共用

Bruno 全局环境变量完全指南一次配置所有集合共用【免费下载链接】brunoOpensource IDE For Exploring and Testing APIs (lightweight alternative to Postman/Insomnia)项目地址: https://gitcode.com/GitHub_Trending/br/brunoBruno 是一款开源的 API 探索与测试客户端常被当作 Postman/Insomnia 的轻量替代。它的全局环境变量让你把哪些配置该被所有集合共享这件事一次性做对URL、令牌、端口写一份处处可用。读完这篇文章你能独立创建全局环境、用脚本动态修改变量、在 CLI 和 CI 里复用同一套配置并绕开最常见的几个坑。一、为什么你需要它先想一个熟悉到头疼的场景你维护着三个集合分别打本地、预发、生产三套后端。每个集合里各存了一份 baseUrl 和 token。现在预发的域名换了——你翻出三处配置逐个改还漏掉了一个CI 红了半天才定位到。更隐蔽的坑是认证。集合 A 登录拿到的 token集合 B 里想用只能手动复制粘贴。值一变所有用到它的地方都要跟着变。全局环境变量Global Environment Variables就是为解决这两类问题存在的配置只存一份所有集合共享还能被脚本改写、在 CI 里注入。它和集合环境最大的区别就一句话——集合环境只对单个集合生效全局环境跟着 Workspace 走跨集合、跨项目都可用。二、核心机制速览在动手之前先用 30 秒把全局环境变量的机制说清楚。Bruno 主界面右上角的环境选择器里Collection 和 Global 两个标签就是这套机制的入口请求里的{{baseUrl}}正是从全局环境取值后拼出真实 URL 的把 Bruno 的变量系统想成一张合并表规则只有三条存成文件每个全局环境就是 Workspace 目录下environments/里的一个.yml文件纯文本可读可改天然适合版本控制。按优先级合并请求发出前全局、集合、环境、文件夹、请求等多层变量按固定顺序合并成一张查找表。占位符取值{{xxx}}写进 URL、Header、Body发请求时从表里查值替换。一句话复述全局环境变量是 Workspace 级的一批.yml配置发请求时按优先级合并{{xxx}}占位符从中取值。机制说清了下面上手。三、从零到一上手创建第一个全局环境第 1 步打开全局环境面板点顶部环境选择器切到Global标签点创建输入环境名比如Local。第 2 步填入键值对在变量表格加一行baseUrlhttp://localhost:8081。值可以是数字或布尔Bruno 会自动识别类型不用手动声明。第 3 步在请求里引用把任意请求的 URL 改成{{baseUrl}}/ping发送。顶部环境选择器里会显示当前激活的全局环境。第 4 步按需再建几个环境照同样方式建Staging、Production切换环境 切下拉框请求定义一个字都不用改。四步走完你已经有了一个可切换的多环境配置层。想知道这一层在代码里到底怎么实现的往下拆。四、拆开看原理变量是怎么合并、写回和插值的上面四步背后代码分三段合并、写回、插值。1. 合并运行时把各层变量按固定顺序展开成一张表后写的覆盖先写的。源码在 packages/bruno-js/src/runtime/assert-runtime.jsconst context { ...globalEnvironmentVariables, // 全局环境最低优先级 ...collectionVariables, ...envVariables, ...folderVariables, ...requestVariables, ...oauth2CredentialVariables, ...runtimeVariables, ...processEnvVars, // 系统进程变量最高 ...bruContext };所以同名变量谁赢是有明确答案的全局环境垫底集合、环境、文件夹、请求、OAuth 凭据、运行时、系统进程变量依次抬高。2. 写回脚本里用bru.setGlobalEnvVar()改全局变量API 定义在 packages/bruno-js/src/bru.jsscript:post-response { bru.setGlobalEnvVar(global_num, 42); // 数字 bru.setGlobalEnvVar(global_bool, true); // 布尔 }脚本运行时只会把变更标记为脏请求跑完后packages/bruno-cli/src/utils/persist-variables.js 负责把变更合并回.yml文件并根据值的类型自动补上dataType标注——这就是第 2 步类型自动识别的来源。3. 插值{{xxx}}的替换在 packages/bruno-common/src/interpolate/ 模块完成。它按正则逐个匹配占位符支持点号取嵌套字段如{{user.name}}支持变量值里再嵌变量的链式替换查不到的占位符会原样保留并触发未解析提示。CLI 侧还有两个关键参数见 packages/bruno-cli/src/commands/run.js--global-env 名称指定使用哪个全局环境文件--global-env-var 键值注入临时值。原理清楚了下面用三个真实任务把这些能力串起来。五、组合实战三个任务串起来任务 1一次登录全 Workspace 共用 token目标集合 A 里登录拿到的 token让集合 B、C 直接可用。做法在登录请求的 post-response 脚本里把响应中的 token 写进全局变量其他任意集合的请求头里写Authorization: Bearer {{authToken}}。效果一次登录所有集合复用。token 还会落盘到环境文件下次启动不用重新登录。任务 2CI 里跑测试密钥不进仓库目标在 CI 中执行 Bruno CLI使用生产全局环境但不把任何密钥提交进仓库。做法bru run request.bru --global-env Production --global-env-var TOKENCI secret效果密钥只活在 CI 的 secret 里通过--global-env-var临时注入。这个注入值有防泄漏保护——不会写进.yml文件本地环境文件保持干净。任务 3环境间继承把重复配置砍掉目标Staging和Base有 80% 相同的配置不想维护两份。做法在Staging环境里声明extends: Base只写差异项。效果Base改一处继承方全部跟着变。这套继承关系同样落在.yml文件里团队通过 Git 同步。三个任务覆盖了三类典型诉求跨集合共享、CI 安全注入、配置去重。真正落地时坑往往藏在细节里。六、避坑与排错清单Q1{{xxx}}原样发出去没被替换原因通常是当前激活的全局环境里没有这个键或拼写不一致。打开环境面板核对变量名确认右上角选中的是 Global 环境仍不放心就在脚本里用bru.getGlobalEnvVar(xxx)打印实际读到的值。Q2脚本里setGlobalEnvVar了为什么没落盘App 中脚本写回默认生效但 CLI 必须显式传--global-env指定目标环境文件不传的话脚本修改只存在于内存跑完即丢。Q3数字、布尔变量被当字符串用了类型信息存在环境文件的dataType标注里。Bruno 写回磁盘时会自动推断并补上手写 YAML 时确保值不带引号42而非42。Q4同名变量打架到底谁生效回到第二节的合并表优先级从低到高依次是全局环境 → 集合变量 → 环境变量 → 文件夹变量 → 请求变量 → OAuth 凭据 → 运行时变量 → 系统进程变量。后合并的赢按这个顺序查表即可。Q5为什么秘文变量的值不落盘这是安全设计不是 bug。标记secret: true的变量值存在独立的加密存储里.yml只留变量名脚本通过setGlobalEnvVar写入的秘文值同样不会写进文件。好处是.yml可以放心提交进 Git。坑排完了最后收个尾。七、延伸阅读全局环境变量这套机制一句话总结就是文件存配置、合并定优先级、脚本可写回。想继续深入建议按这个顺序读插值引擎packages/bruno-common/src/interpolate/脚本 APIpackages/bruno-js/src/bru.js变量写回逻辑packages/bruno-cli/src/utils/persist-variables.jsCLI 参数packages/bruno-cli/src/commands/run.js中文文档入口docs/readme/readme_cn.md把全局环境当配置层来用你的 Bruno 工作流就真正搭起来了。【免费下载链接】brunoOpensource IDE For Exploring and Testing APIs (lightweight alternative to Postman/Insomnia)项目地址: https://gitcode.com/GitHub_Trending/br/bruno创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考