Postman 是 macOS 上常用 API 调试工具，支持环境变量、集合管理、Mock Server 和自动化测试；需官网下载安装，通过环境（Environments）隔离多环境配置，可导入 OpenAPI 或手动建集合，并用 Pre-request Script 动态生成参数。

Postman 是 macOS 上最常用的 API 调试工具之一，安装简单、界面直观，且原生支持环境变量、集合、Mock Server 和自动化测试。它能帮你快速验证接口行为，同时通过「环境（Environments）」功能实现开发、测试、生产等多环境的请求参数隔离，避免手动切换 Host 或 Token 出错。

一、从官网下载并安装 Postman

Postman 官方已不再提供 Mac App Store 版本，推荐直接使用官网分发的原生 macOS 应用（基于 Electron，但优化良好）：

• 访问 https://www.postman.com/downloads/，点击「Download for Mac」获取 .zip 文件
• 解压后将 Postman.app 拖入「应用程序」文件夹
• 首次运行时若提示“无法验证开发者”，需前往「系统设置 → 隐私与安全性」，点击「仍要打开」
• 建议在 Dock 中右键 Postman →「选项 → 在登录时打开」，便于常驻使用

二、创建并切换环境（Environment），实现配置隔离

环境是 Postman 实现 API 配置复用和安全隔离的核心。每个环境是一组键值对（如 base_url = https://api.dev.example.com），可在请求中通过 {{base_url}}/users 引用。

• 点击右上角「No environment」下拉框 →「Manage Environments」→「+ Add」
• 新建三个常用环境：dev / test / prod，分别填入对应域名、API Key、Token 等变量
• 在请求 URL 或 Headers 中使用双大括号语法引用，例如：
  GET {{base_url}}/v1/profile
  Authorization: Bearer {{auth_token}}
• 切换环境后，所有已关联该环境的请求会自动更新变量值，无需修改任何请求本身

三、导入 OpenAPI/Swagger 或手动组织集合（Collection）

把接口按业务模块组织成 Collection，再为每个接口指定环境变量，可大幅提升协作与复用效率：

• 点击左上角「Import」→ 可导入 JSON/YAML 格式的 OpenAPI 3.0 文档（适合已有后端 Swagger）
• 或点击「+ New Collection」手动添加请求，支持设置请求方法、参数（Params/Body）、Headers、Pre-request Script 和 Tests
• 为 Collection 设置默认环境：点击 Collection 名称右侧「⋯」→「Edit」→「General」选项卡 →「Default environment」下拉选择
• 推荐为每个 Collection 添加描述和示例请求，方便团队成员快速上手

四、进阶技巧：用 Pre-request Script 动态生成参数

当需要每次发送前动态计算时间戳、签名、JWT 或随机 ID 时，Pre-request Script 是轻量级解决方案：

• 在请求编辑页 →「Pre-request Script」标签页中写 JavaScript（基于 Node.js 子集）
• 例如生成当前时间戳并存入环境变量：
  pm.environment.set("timestamp", Date.now().toString());
• 再在请求 Body 或 Params 中使用 {{timestamp}} 即可
• 注意：Script 运行在请求发出前，不涉及网络请求；如需调用其他 API，应使用 Collection Runner 或 Newman 配合脚本