Postman 用环境变量切换 API 地址的操作步骤

同一个接口在测试、预发布和生产环境之间切换时，最稳妥的做法不是反复改请求 URL，而是把主机地址放进 Postman environment。请求只保留 {{base_url}}/users，切换右上角的活动环境后，变量引用就会跟着变化。

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

步骤一：先把测试和生产环境分开

打开 Postman，在左侧选择 Environments，分别创建“测试环境”和“生产环境”。也可以在工作区右上角的环境选择器旁点击新增入口创建环境。环境创建后，先选中“测试环境”，让它成为当前活动环境。

这样做的关键是把“环境名称”和“变量值”分开：环境名称负责切换，变量值负责指向具体 API。不要把测试地址和生产地址混在同一个环境里，否则后续排查很难判断请求到底发往哪里。

步骤二：为每个环境添加 base_url

在环境编辑表的最后一行点击 Add variable，变量名填写 base_url。测试环境的本地值可以写成 https://api.test.example，生产环境则写成 https://api.prod.example。示例域名只是占位符，请替换成你的真实服务地址。

若地址包含密钥、账号或内网信息，不要把敏感内容直接写入文章、集合或截图。Postman 文档区分本地值与共享值：本地值用于当前实例发送请求，是否同步给团队要按协作权限决定。编辑完成后确认变量行仍处于启用状态，修改会自动保存。

步骤三：让请求 URL 引用环境变量

打开要复用的请求，把原来的固定主机改为下面这种形式：

GET {{base_url}}/users

// {{base_url}} 由当前活动环境提供，/users 保持接口路径不变
// 发送前先确认变量提示显示的是预期主机，避免把测试请求发到生产环境

Postman 的环境变量可以出现在 URL、参数、请求头和 body 中。将鼠标放到 {{base_url}} 上，界面应能显示当前活动环境解析出的值；如果没有解析值，先检查环境是否已激活、变量名是否拼写一致，以及变量行是否被禁用。

步骤四：切换后用三个状态确认目标已变

先在右上角环境选择器切换到“生产环境”，再按下面顺序核对：

1. 选择器显示“生产环境”，而不是仅仅打开了环境编辑页。
2. 工作区的变量面板显示 base_url 的生产本地值。
3. 请求 URL 仍是 {{base_url}}/users，变量提示解析到生产主机后再点击 Send。

发送后，响应状态只能说明请求得到了响应，不能单独证明目标环境正确。因此要把活动环境、解析值和请求记录放在一起看。需要批量运行 Collection Runner 或监视器时，也要确认运行配置使用了同一个环境。

常见问题

为什么 URL 里的 {{base_url}} 没有变成地址？

通常是没有选择活动环境、变量名不一致，或变量行被禁用。先从右上角选择环境，再打开变量面板检查名称和值。

环境变量和全局变量同名时用哪个？

Postman 会按变量作用域选择值；同名时环境变量通常优先于 collection 和 global 变量，但 local 与 data 变量可能继续覆盖它。看到变量被划线时，要顺着作用域检查。

为什么测试和生产环境应该分开？

分开后切换动作是显式的，地址、认证配置和团队共享范围也更容易审查。请求本身保持不变，减少批量改 URL 带来的漏改风险。

完成后可以保留一条不带敏感信息的演示请求，确认环境选择器、变量解析和响应目标三处一致，再把真实密钥交给合适的安全存储或团队权限管理。