开发工具 Postman 环境变量切换地址 怎样处理

Postman 切换环境后仍然请求旧地址，先检查右上角是否真的选中了目标环境，再检查请求 URL 是否使用了 {{base_url}} 变量。开发、测试和生产环境应该分别保存自己的 base_url，发送请求时由当前环境提供值，而不是在每个请求里手工改域名。

官方地址：https://www.postman.com/

官方文档：https://learning.postman.com/latest-v-12/docs/use/send-requests/variables/managing-environments

先确认当前环境决定哪个地址

Postman 的环境是一组按工作场景组织的变量。比如 Development 可以指向开发服务，Test 可以指向测试服务；切换当前环境后，请求和脚本引用的环境变量会使用新环境中的值。不要只打开了多个环境就认为它们会自动轮换，真正生效的是右上角环境选择器中显示的当前项。

打开工作区后，先看右上角环境选择器，再从侧栏进入 Environments。确认当前项不是 No environment，也不要把全局变量误当成环境变量。变量面板适合快速查看当前请求能访问到哪些变量。

创建环境并填写 base_url

在侧栏打开 Environments，创建或选择一个环境，新增变量名 base_url。分别建立 Development 和 Test 时，变量名保持一致，只替换各自的地址值。这样请求只依赖变量名，不依赖具体环境名称。

Postman 的环境编辑器会区分本地使用的 Current value 与可选共享值。接口地址通常属于团队协作配置，但密钥、密码和令牌不要写进文章示例或提交到公开仓库；需要共享时按团队权限和 Postman 的安全设置处理。修改完成后确认变量处于启用状态，并保存环境。

示例配置可以写成下面的 JSONC，注释只说明字段用途；它不是导入文件，而是帮助你核对变量命名：

{
  // 当前环境用于替换请求 URL 中的主机部分
  "base_url": {
    // 本地发送请求时使用的测试地址
    "current": "https://test-api.example.com"
  }
}

在请求中使用变量地址

打开请求，把原来写死的 https://test-api.example.com/users 改成 {{base_url}}/users。双大括号是 Postman 变量引用语法；变量名必须和环境编辑器中的名称完全一致，包括下划线。

如果当前选择 Development，请求会使用 Development 的 base_url；切换到 Test 后，同一条请求会改用 Test 的值。注意路径部分仍然属于请求本身，例如 /users 不要重复放进环境变量，否则多个接口组合时容易出现双斜杠或路径缺失。

看到变量引用旁边出现当前值提示，说明 Postman 已经找到变量；如果只显示未解析的名称，先不要发送请求，回到环境选择器和变量表检查。

切换环境后确认地址已经替换

在右上角选择 Test，回到请求地址观察 {{base_url}} 的解析提示，再打开变量面板确认 base_url 的 Current value。确认三处信息一致后再发送请求：当前环境是 Test，请求使用变量模板，Test 环境的地址值也正确。

地址仍然不生效时的排查顺序

排查时不要同时修改请求、环境名和变量名。先固定变量名 base_url，只切换环境并观察当前值；再检查请求模板；最后处理协作权限。这样能区分“没有选环境”和“环境值没有保存”两类问题。

常见问题

切换环境后为什么地址没有变化？

最常见的原因是请求 URL 仍然写着完整域名。环境切换只会影响请求中引用的变量，不会改写普通文本。把主机部分替换为 {{base_url}} 后再观察解析提示。

Current value 和共享值应该填哪个？

Current value 用于本地发送请求；需要与团队同步时，再根据权限选择是否共享。令牌、密码等敏感信息不要为了方便直接写入公开集合或文章示例。

一个请求可以同时使用多个环境变量吗？

可以。例如把主机、版本前缀和租户标识分别设为变量，但先保持变量职责单一。地址切换问题优先从一个清晰的 base_url 开始，确认解析稳定后再扩展。