环境变量语法与引用方法:一套请求适配多个环境
接口要在开发、测试、生产三套环境之间来回打,手动改 URL 和参数太容易出错。环境变量就是为这件事准备的。
引用语法
在输入框里用尖双括号引用变量,例如 <<variable_name>>。引用位置覆盖很全:
- 请求 URL;
- 查询参数;
- 请求头部;
- 请求体;
- 请求授权。
输入尖括号 < 后会自动弹出变量提示,悬浮在变量上可以看到变量详情。

发送时自动替换
发送请求时,Reqable 自动把引用替换成当前环境的实际值:

环境切换
侧边栏的「环境变量」面板(快捷键 F3)管理变量方案;标签栏最右侧显示当前环境,点击即可整体切换。切换环境后,所有引用变量的请求自动指向新环境的地址与凭据。

配合集合使用
- 从 Postman、Swagger 等工具导入集合时,集合里的环境变量会一并导入(见 导入第三方集合);
- 集合可以定义公共参数与请求头,被集合内的 API 自动继承,与环境变量配合实现「公共配置一处改、全部请求生效」。
一个典型的三环境布局
base_url 开发=http://dev.local:8000 测试=https://test-api.example.com 生产=https://api.example.com
token 按环境各存一份
请求 URL 写成 <<base_url>>/v1/users,授权用 Bearer <<token>>,切环境只动一个下拉框。
未登录账号时环境变量等数据保存在本机;登录后可云同步多设备使用,见 版本对比。