Hoppscotch全局变量设置教程

Hoppscotch全局变量是提升API测试效率的关键功能，它允许用户在“设置→全局环境”中统一配置如API前缀、默认请求头等基础参数，支持文本与密钥类型变量（后者自动隐藏敏感值），并通过{{变量名}}语法在URL、Headers、Body甚至Pre-request Script中无缝调用；更可通过脚本动态生成时间戳、签名等运行时值，并写入全局作用域供跨请求复用——特别适合多环境协作、避免重复配置、保障一致性场景，只需确保使用v2.4.0+版本并注意其优先级低于局部环境变量即可轻松上手。

如果您在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、若仍显示>，检查变量名拼写是否完全一致（区分大小写），并确认未在当前激活环境中定义同名变量造成覆盖。

本篇关于《Hoppscotch全局变量设置教程》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！