全局变量需在右上角齿轮→Manage Environments→Globals标签页设置,否则易误设为环境或集合变量;其值受优先级规则影响(局部>集合>环境>全局),同名时会被覆盖,且须手动保存、避免空格与大小写错误。

全局变量不是“设了就能用”,关键看它是否被正确加载、引用和覆盖——尤其当环境变量或集合变量同名时,{{key}} 会静默取到别的值。
全局变量在哪设置?别点错位置
Postman 的全局变量入口藏得有点深:必须点右上角齿轮图标 → “Manage Environments” → 切换到 “Globals” 标签页。不是点击左上角 “Environments” 图标(那是环境变量入口),也不是在请求里点 “Variables”(那是集合变量)。这里填的 Key 和 Value 会立即对所有集合、所有环境生效,哪怕当前是 No Environment 状态。
常见错误:
- 误在
Environment页面下新建变量,结果建成了环境变量,只在选中该环境时才可用 - 输完没按
Save或没 Ctrl+S,变量实际未保存(Postman 不自动保存) - Key 名含空格或特殊字符(如
base url),导致{{base url}}解析失败
怎么在请求里安全引用?注意作用域和拼写
{{key}} 可以出现在 URL、Headers、Params、Body(raw/json/form-data)、甚至 Pre-request Script 和 Tests 里。但它的值取决于变量是否存在、是否被覆盖、以及你当前是否处于某个环境。
优先级规则必须牢记:局部变量(如 Tests 中用 <code>pm.variables.set()) > 集合变量 > 环境变量 > 全局变量。比如你同时设置了:
Postman 12.27.7 Windows x64 官方安装包,适用于 API 设计、调试、测试与协作。该系列包含 Enterprise 云端性能测试静态 IP 出口能力,以及接口规范标签管理改进,适合受限网络测试与规范资源组织场景。
- 全局变量
base_url = https://api.dev.com - 环境变量
base_url = https://api.test.com - 当前又选中了该测试环境
那么 {{base_url}} 解析出的永远是 https://api.test.com,全局变量被静默屏蔽——这常导致你以为改了全局却没生效。
验证是否真取到全局值:鼠标悬停在 {{key}} 上,弹出框显示的值才是真实解析结果;也可在 Tests 里加 console.log(pm.globals.get("key")) 查看。
如何动态更新全局变量?别只靠手动填
登录后获取 token 并复用到后续所有请求,是全局变量最典型场景。这时不能手动填,得靠脚本从响应中提取:
- 在登录请求的 Tests 标签页写:
pm.globals.set("token", pm.response.json().access_token) - 确保响应是 JSON 格式,否则
pm.response.json()会报错;可先加pm.test("Response is JSON", () => pm.response.to.be.json)做断言 - 如果 token 存在响应头(如
X-Auth-Token),改用:pm.globals.set("token", pm.response.headers.get("X-Auth-Token")) - 敏感值(如密码、临时 token)建议只设
Current Value,不填Initial Value,避免同步到团队云端
为什么变量突然不生效?检查这三点
变量“消失”往往不是 Postman 坏了,而是配置链断了:
-
环境选择器状态干扰:即使你用的是全局变量,如果右上角环境选择器显示为某个具体环境(而非
No Environment),且该环境中定义了同名变量,它仍会覆盖全局值 -
变量名大小写不一致:
{{Token}}和{{token}}是两个变量,Postman 区分大小写 -
URL 缺少协议或斜杠:比如全局设了
base_url = api.example.com,请求写成{{base_url}}/user,实际发出的是http://api.example.com/user(Postman 自动补http://),可能被服务端重定向或拒绝——务必写成https://api.example.com
最易被忽略的一点:全局变量在 Collection Runner 中默认不持久化。如果你用 Runner 批量跑接口并依赖全局 token,需在 Runner 设置里勾选 Persist Variables,否则每次迭代都会丢失上一次脚本设置的值。

















