hoppscotch支持环境变量配置与一键切换:一、顶部环境选择器快速切换;二、ctrl+e/cmd+e快捷键切换;三、命令面板模糊匹配切换;四、请求中直接引用{{变量名}};五、预请求脚本动态设值。

如果您在使用Hoppscotch进行API测试时,需要在开发、测试、生产等不同环境中反复修改URL、认证令牌或密钥,则手动替换不仅低效且易出错。以下是实现环境变量配置与一键切换的多种具体操作路径:
一、通过顶部环境选择器快速切换
该方式利用Hoppscotch内置的全局环境选择下拉菜单,直接触发当前会话中所有请求变量的批量替换,无需刷新页面或重新配置请求。
1、点击界面右上角图层图标(堆叠方块形状),打开环境选择下拉菜单。
2、若尚未创建环境,先点击菜单底部的「我的环境」→「新建环境」,输入环境名称(如“测试环境”)。
3、在变量编辑区域添加键值对:例如键为api_base_url,值为https://api-test.example.com;键为auth_token,勾选「秘密变量」后填入令牌。
4、保存后返回请求编辑页,在顶部环境选择器中点击目标环境名称,所有含{{api_base_url}}或{{auth_token}}的字段将立即更新。
二、使用快捷键触发环境切换
该方式适用于高频切换场景,绕过鼠标操作,通过键盘指令直接调用环境管理逻辑,响应延迟低于200ms。
1、确保Hoppscotch主窗口处于焦点状态(非输入框内)。
2、按下Ctrl + E(Windows/Linux)或 Cmd + E(Mac),弹出环境选择浮层。
3、使用上下方向键高亮目标环境,按回车确认切换。
4、已激活环境名称将实时显示在顶部导航栏右侧,且所有请求中的{{变量名}}自动完成解析。
三、通过命令面板执行环境切换指令
该方式基于Hoppscotch的命令驱动架构,调用内部注册的“切换环境”命令,支持模糊匹配与历史环境快速召回。
1、按下Ctrl + Shift + P(Windows/Linux)或 Cmd + Shift + P(Mac),唤出命令面板。
2、在输入框中键入“切换环境”,面板自动过滤并高亮对应命令。
3、按回车执行,命令面板转为环境列表视图,支持键盘搜索环境名称首字母。
4、选择目标环境后,系统立即应用其全部变量至当前工作区,包括请求头、URL路径及请求体中的变量占位符。
四、在请求中直接引用环境变量
该方式将环境变量注入具体HTTP请求结构,实现参数动态化,避免硬编码导致的配置污染与安全风险。
1、在请求URL栏输入:https://{{api_base_url}}/v1/users,其中{{api_base_url}}需已在当前选中环境中定义。
2、在Headers区域新增一行:Key填写Authorization,Value填写Bearer {{auth_token}}。
3、在Body(JSON)中插入字段:"client_id": "{{client_id}}",确保client_id已在环境变量中声明并赋值。
4、发送请求前,Hoppscotch自动扫描所有{{xxx}}语法节点,从当前环境变量集合中提取对应currentValue进行替换。
五、通过预请求脚本动态设置变量值
该方式借助JavaScript运行时能力,在每次请求发起前执行自定义逻辑,实现令牌续期、时间戳注入等动态行为。
1、点击请求编辑区右上角「预请求脚本」标签页。
2、输入以下代码:pm.environment.set("timestamp", Date.now().toString());
3、在请求URL中使用该变量:https://{{api_base_url}}/log?ts={{timestamp}}。
4、每次点击「发送」按钮时,脚本自动执行并更新timestamp变量值,确保每次请求携带唯一时间戳。











