Postman

Postman 是面向 API 开发流程的客户端与协作平台，可发送 HTTP、GraphQL、gRPC 和 WebSocket 请求，并用 Collection、环境变量、脚本和测试组织可复用工作流。本文以桌面应用为主，带你完成第一次请求、环境切换、响应断言和 Collection 运行，同时说明 Web App、Desktop Agent、CLI 与敏感变量的边界。

桌面应用、Web App 与 Agent 如何选

Postman 桌面应用支持 Windows、macOS、Linux 的 Intel/ARM 架构，适合完整 API 开发、离线工作流和 Native Git；Web App 可完成许多请求与协作任务，但部分功能受限。需要访问本机网络、证书或代理时，按官方文档安装并运行 Postman Desktop Agent。Postman CLI 是单独的命令行入口，不等同于桌面应用。

安装后先建立一个安全的工作区

1. 从官方下载页按操作系统和 CPU 架构选择安装包；macOS ZIP 解压后将应用移入 Applications，Linux 可使用官方包或 Snap。
2. 登录或选择合适的 Workspace，确认这是个人、团队还是临时测试空间。
3. 新建 Collection，给请求使用可识别的名称；不要把真实密码、令牌或生产密钥直接写进共享请求。

发送第一个请求

新建 Request，选择方法并填入测试 API URL，按接口要求填写 Query Params、Headers、Authorization 和 Body，然后点击 Send。先阅读状态码、响应头和响应体，再保存请求；保存时记录它需要的环境、认证方式和预期结果。遇到重定向、证书或跨域问题，先区分服务端响应与客户端环境问题。

用 Environment 切换地址和令牌

将开发、测试、生产的基础 URL 分成不同环境，用变量引用，例如 {{baseUrl}}。敏感变量应使用 Postman 的受保护值或 Vault 等安全机制，避免把令牌提交到 Collection、导出 JSON 或截图。发送前查看当前激活环境和变量解析结果，防止把测试请求发到生产服务。

脚本和测试：把一次调试变成可重复检查

在请求前脚本中生成时间戳或准备动态数据，在 Tests 中断言状态码、响应字段和业务条件。断言应针对接口契约写出清晰失败信息；先运行单个请求验证脚本，再放入 Collection Runner。测试通过不代表接口安全或业务正确，仍要结合服务端日志和权限策略。

Collection、同步与 CLI 的分工

Collection 负责组织请求、示例、脚本和测试，Workspace 决定协作范围。重复执行时可用 Collection Runner；需要 CI/CD 时再使用 Postman CLI 和明确的环境文件。同步前检查共享成员、变量可见性、导出内容和许可证/套餐限制，不能把“能同步”理解为“所有秘密都会安全保存”。

常见问题

• 请求失败：先看 URL、方法、认证、代理、证书和服务端状态码，不要先重装客户端。
• 变量没有替换：确认环境已激活、变量名大小写一致，并检查当前值与初始值。
• Web App 不能访问本机 API：按官方说明使用桌面应用或 Desktop Agent。
• 测试脚本不通过：单独打印响应结构，确认断言路径和接口版本。
• 更新或安装失败：检查安装包架构、代理和公司安全软件；桌面应用与 CLI 需分别更新。

本文核验日期为 2026-09-06。Postman 的桌面、Web、Agent、CLI 和套餐能力会独立变化，实际安装和协作前请以官方 Downloads 与 Learning 文档为准。