hoppscotch中需通过设置→global environment配置全局变量以统一api前缀等参数,支持文本/密钥类型、预请求脚本动态写入,并在请求中用{{}}调用,优先级低于环境变量。

如果您在Hoppscotch中需要为所有请求统一提供基础配置(如通用API前缀、默认认证头或跨环境共享的常量),但每次手动填写重复参数导致效率低下,则可能是由于未启用或未正确配置全局环境变量。以下是实现全局环境变量配置与调用的具体操作步骤:
一、启用并进入全局环境管理界面
全局环境变量是作用域最广的变量类型,自动应用于当前用户所有请求,无需在每个环境中单独定义。其配置入口独立于个人/团队环境,需通过特定路径访问。
1、点击Hoppscotch左侧面板底部的齿轮图标(Settings),而非地球图标(Environments)。
2、在设置弹窗中,切换至"Global Environment"标签页。
3、若该标签页未显示,请确认您使用的是v2.4.0及以上版本;旧版本需升级后方可启用全局变量功能。
二、定义全局变量并设置初始值
全局变量支持文本、密钥两种类型,其中密钥类型会自动隐藏值字段内容并禁用明文导出,适用于JWT_SECRET、DEFAULT_TIMEOUT等非敏感但需统一控制的参数。
1、在“Global Environment”标签页内,点击"Add Variable"按钮。
2、在变量名列输入名称,例如BASE_API_URL;注意命名须全部小写或采用下划线分隔,避免空格与特殊字符。
3、在值列输入对应内容,例如https://api.example.com/v2;若为密钥类型,勾选"Secret variable"复选框。
4、点击"Save Global Environment"完成提交。
三、在请求中调用全局变量
全局变量在请求任意字段中均可直接引用,系统按>语法解析,且优先级低于当前激活环境变量,确保局部覆盖能力。
1、新建或打开任意请求,在URL输入框中输入:>/users。
2、在Headers区域添加键值对:Key为X-Client-Version,Value为>(前提是已定义该全局变量)。
3、在Body(JSON)中插入字段:"timestamp": ">",该变量可配合Pre-request Script动态生成。
四、通过Pre-request Script动态写入全局变量
当需要根据运行时逻辑生成变量值(如时间戳、随机数、签名摘要),可借助Pre-request Script脚本将计算结果写入全局作用域,供本次及后续请求使用。
1、在目标请求的编辑区,切换至"Pre-request Script"标签页。
2、输入以下JavaScript代码:pm.globals.set("CURRENT_TIMESTAMP", Date.now().toString());
3、保存请求后,再次发送时该脚本将在请求发出前执行,并将毫秒级时间戳写入全局变量CURRENT_TIMESTAMP。
4、该变量即可在同一次会话中的其他请求里被>语法调用。
五、验证全局变量是否生效
变量是否成功注入取决于解析时机与作用域匹配,错误配置会导致空值或原始字符串残留,需通过响应调试确认实际替换结果。
1、在请求发送前,点击右上角"Preview Request"按钮。
2、查看预览窗口中URL、Headers、Body各字段,确认>已被真实值替代,例如https://api.example.com/v2/users而非原始模板。
3、若仍显示>,检查变量名拼写是否完全一致(区分大小写),并确认未在当前激活环境中定义同名变量造成覆盖。











