Postman 环境变量怎么配置或排查

Postman 的环境变量配置不生效，通常不是变量名本身错了，而是环境没有激活、只填了共享值、改动没有落到当前工作区，或同名变量被更高优先级的值覆盖。按“创建环境→填写本地 Value→激活→在请求中解析→检查作用域”的顺序处理，基本可以定位问题。

官方地址：https://learning.postman.com/docs/use/send-requests/variables/managing-environments/

第1步：先确认请求确实引用了环境变量

打开一个请求，把 URL 写成 {{base_url}}/get，或把同样的变量放进 Header、参数和 Body。双大括号是 Postman 的变量引用语法。鼠标移到变量名上，如果能看到当前值，说明语法已被识别；仍显示为未解析，优先检查激活环境，不要先去改接口地址。

第2步：从 Environments 创建变量并填写本地值

左侧导航点击 Environments，再点击新增入口创建环境，命名为“测试环境”。进入环境编辑页，新增变量 base_url，在 Value 栏填写 https://postman-echo.com。如果还要模拟鉴权，可增加 api_token，但示例只放演示值，不要把真实密钥写进文章、截图或集合。

需要保密的变量可点击变量行旁的 Secure。注意区分本地 Value 与 Shared Value：发送请求使用当前 Postman 实例中的本地 Value；只有在需要同步给团队或让云端功能读取时，才考虑共享。变量修改会自动保存，保存后先留在当前环境页面核对变量名拼写。

第3步：在右上角激活环境，再检查当前值

回到请求工作台，点击右上角的环境选择器，选择刚才的“测试环境”。如果这里仍显示 No environment，即使环境编辑页里已经有变量，请求也不会使用它。激活后点击工作台右上角的 Variables 图标，查看当前环境对这个请求暴露的变量和值。

这一页重点核对三件事：环境名称是否正确、变量名是否与请求中的拼写完全一致、Local Value 是否为空。不要只看共享列或示例列；请求发送前要以本地值为准。

第4步：用请求结果和脚本确认变量已经解析

再次发送 {{base_url}}/get 请求。示意状态中，URL 预览应显示完整的 https://postman-echo.com/get，响应区再出现 200 等结果，才说明变量替换已经发生；真实接口是否成功仍要由接口返回内容判断。

如果需要在脚本中读取当前环境值，可以使用下面的最小检查。它只验证变量是否存在，不打印令牌内容：

// 读取当前激活环境中的地址，避免把敏感值输出到日志
const baseUrl = pm.environment.get("base_url");

// 只检查是否为非空字符串，失败时提示先激活环境或填写 Local Value
pm.test("base_url 已配置", function () {
  pm.expect(baseUrl, "请先激活环境并填写 Local Value").to.be.a("string").and.not.empty;
});

第5步：同名变量不生效时按作用域排查

如果 Variables 面板能看到值，但请求使用的仍不是预期地址，检查是否存在同名变量。Postman 会优先使用作用域更窄的值：本地变量和数据变量会覆盖环境变量；环境变量会覆盖集合变量和全局变量。被覆盖的值通常会以删除线等状态提示出来。

建议按这个顺序处理：先在请求级变量和运行数据中搜索 base_url，再看当前环境，最后检查集合和全局变量。若只是想临时切换测试地址，修改当前环境的 Local Value；若想消除歧义，给集合变量改成不同名称，并同步修改请求引用。修复后重新激活环境、打开 Variables 面板、悬停变量并发送一次请求，四处状态都一致，配置才算完成。

常见问题

为什么环境里有变量，请求却显示未解析？

最常见原因是右上角仍为 No environment，或请求中的变量名与环境变量名大小写、下划线不一致。先激活目标环境，再从 Variables 面板确认本地值。

Shared Value 和本地 Value 应该填哪一个？

单机调试优先填写本地 Value；需要团队同步或云端执行时，再根据权限和敏感性决定是否共享。令牌、密码等值不要为了“方便”直接共享。