Postman：API 调试工具

为什么你需要 Postman

日常开发中，前后端联调、第三方接口对接、本地 mock 数据，都离不开 API 调试。直接用浏览器地址栏只能发起 GET 请求，遇到 POST、PUT 或需要携带 Header、Token 的接口，就得反复写临时脚本。而 Postman 把请求组织、参数填写、响应查看都收进一个图形界面，省去大量重复劳动。更关键的是，它能保存历史请求，团队协作时可以直接分享接口集合，新人接手项目不再需要口头追问接口地址和参数格式。

核心功能：不只是发请求

集合与环境管理

Postman 的 Collection（集合）功能，可以把一个项目的所有接口按模块归档，支持文件夹分层。配合 Environment（环境变量），一键切换开发、测试、生产环境，接口的 Base URL 和密钥不用每处改动。例如在环境变量中定义 {{baseUrl}}，请求 URL 里直接引用，换环境时只需切换右上角的下拉选项。

自动化测试与脚本

Postman 内嵌 JavaScript 沙箱，可以在请求前后执行脚本。发送前用 pm.variables.set 动态生成签名或时间戳，发送后用 pm.test 断言状态码和响应字段。这样每次修改代码后，跑一遍 Collection Runner 就能快速验证核心接口是否异常，比人工点按高效得多。

下载与安装步骤

Postman 官方提供 Windows、macOS、Linux 三个平台的安装包。你可以在官网点击“Download”按钮，也可以直接通过包管理器安装（如 macOS 的 brew install --cask postman）。Windows 用户拿到安装包后，运行 exe 文件，保持默认路径即可。注意：Postman 需要联网登录账号才能使用完整功能，首次启动时会要求注册或登录，用 Google 或 GitHub 账号可以快速进入。

如果你处于离线环境，想在内部网络使用 Postman 下载安装，建议提前从官网获取安装包，并确认版本号。因为 Postman 更新频繁，离线安装后可能需要手动禁用自动更新，否则每次启动会弹出升级提示，影响体验。另外，Linux 用户下载的是 tar.gz 压缩包，解压后运行 ./Postman 即可，无需 root 权限。

使用要点与注意事项

• 请求参数对比：在 Postman 中，GET 请求的查询参数写在 Params 标签，POST 请求的 body 根据接口文档选择 form-data、x-www-form-urlencoded 或 raw JSON。如果接口报 415，多半是 Content-Type 没选对。
• 鉴权方式：需要携带 Token 的接口，可以在 Authorization 标签选择 Bearer Token 或 API Key，Postman 会帮你自动添加请求头。如果 Token 会过期，建议写一个登录脚本自动刷新，存到环境变量里。
• 避免敏感信息泄露：团队共享集合时，不要把真实密码和密钥写死在请求里。使用环境变量或 Postman 的 Vault 功能保存机密，分享时只分享集合，不分享环境变量。

拿到 Postman 下载包后，建议花十分钟熟悉快捷键：Ctrl+Enter 发送请求，Ctrl+S 保存到集合，Ctrl+Shift+N 新建环境。这样后续操作能快不少。

实际使用中，遇到跨域或 SSL 证书问题，可以在设置里关闭 SSL 校验（仅限本地测试）。Postman 还支持导入 OpenAPI、Swagger 格式的接口定义，自动生成请求集合，团队从文档到联调可以无缝衔接。