Postman在Ubuntu上如何管理环境变量

在Ubuntu上管理 Postman 环境变量

一 核心概念与优先级

• 环境 Environment：为不同场景（如开发/测试/预发/生产）分别维护一组变量，便于一键切换。
• 全局 Global：对所有请求都生效的变量，适合放通用配置（如公共域名后缀）。
• 作用域与优先级：环境变量 > 全局变量。同名时以环境为准，便于按环境覆盖配置。

二 创建与切换环境

• 打开 Postman，点击顶部 Environments 或右上角的 Manage Environments。
• 在弹窗中点击 Add，填写环境名称，在键值表中添加需要的变量（如：base_url、api_key），保存。
• 使用右上角的环境选择器切换到目标环境；此后请求中将自动解析该环境的变量。

三 在请求中使用变量

• 在 URL/Params/Headers/Body 中以双大括号引用：如 {{base_url}}/api/users、X-Api-Key: {{api_key}}。
• 在 Pre-request Script / Tests 中读写：
  • 读取：const v = pm.environment.get(“var_name”);
  • 写入：pm.environment.set(“var_name”, “value”);
• 示例（登录后将 token 写入环境，供后续请求使用）：
  • Tests:

    const json = pm.response.json();
    if (json.token) {
      pm.environment.set("auth_token", json.token);
    }
    

  • 其他请求 Header:

    Authorization: Bearer {{auth_token}}
    

• 小技巧：在请求参数或代码里将鼠标悬停在变量上可预览解析值，便于排查。

四 导入导出与团队协作

• 在 Manage Environments 中可 Import/Export 环境，文件为 JSON 格式，便于与团队成员共享或在多机间同步。
• 常见做法：将环境 JSON 纳入版本控制（不含敏感信息），敏感项（如密码/密钥）通过 Postman 的安全机制或在运行时注入。

五 常见问题与排查

• 变量未解析（仍显示 {{xxx}}）：检查是否选对了当前环境，变量名是否拼写一致，是否在该环境的变量表中定义。
• 作用域覆盖问题：同名时环境变量会覆盖全局变量；如需统一默认值，请在全局定义，在环境按需覆盖。
• 需要临时调试而不改环境：可在请求的 Pre-request Script 中 pm.environment.set 临时值，或在请求前脚本里打印调试信息（如 console.log）辅助定位。