Postman 使用教程：API 开发与测试必备工具

Postman 是什么：一款覆盖 API 全生命周期的协作平台

Postman 诞生于 2012 年，最初只是一个简单的 Chrome 浏览器扩展，用来帮助开发者更方便地构造 HTTP 请求。经过十多年的迭代，它已经从一个请求构造器演变为一套覆盖 API 设计、调试、测试、文档、Mock、监控、协作 的综合性平台。如今，无论是后端工程师调试接口、前端工程师联调数据，还是 QA 工程师编写自动化测试用例，都能在 Postman 中找到对应的功能模块。

它的核心定位可以归纳为三点：

• 一体化：把过去散落在 cURL 命令、Swagger 文档、自动化测试脚本、Mock 服务里的工作，集中到同一个界面。
• 协作化：通过 Workspace、团队空间、云同步等机制，让多人共享同一套 API 资产。
• 可扩展：通过 Pre-request Script、Tests 脚本、Newman CLI、CI/CD 集成等方式，把 API 测试嵌入到 DevOps 流程里。

核心功能拆解

Postman 的功能模块非常多，初学者往往会被复杂的侧边栏劝退。下面按使用频率从高到低梳理几个关键能力。

请求构造与发送

这是 Postman 最基础也最常用的功能。界面顶部可以选择请求方法（GET、POST、PUT、PATCH、DELETE 等），URL 栏支持占位符与环境变量引用，下方则分为 Params、Authorization、Headers、Body、Pre-request Script、Tests 等多个标签页。

支持的请求体类型包括：

• form-data：模拟表单提交，常用于文件上传
• x-www-form-urlencoded：传统表单编码
• raw：JSON、XML、纯文本等
• binary：上传二进制文件
• GraphQL：内置 GraphQL 查询构造器

发送请求后，响应区会显示状态码、耗时、数据大小、响应头、响应体。响应体可以根据内容类型自动美化（Pretty 视图），也可以切换为 Raw、Preview（HTML 预览）等模式。

环境变量与全局变量

在多环境开发中（开发、测试、预发、生产），硬编码 baseURL 显然不合理。Postman 的 Environments 功能允许你为每个环境定义一组变量（如 {{base_url}}、{{token}}），切换环境时所有变量自动生效。

变量的作用域分为三层：

集合管理与文件夹

Collection 是 Postman 组织 API 请求的基本单位。一个 Collection 可以包含多个 Request，支持嵌套文件夹、批量运行、批量导出，也支持从 OpenAPI/Swagger 规范一键导入。Collection 还能生成可分享的文档页面，方便前后端协作。

自动化测试（Tests 脚本）

在请求的 Tests 标签页中，可以使用 JavaScript 编写断言脚本。常见的用法包括校验状态码、解析 JSON 响应、校验字段值等。Postman 内置了一些常用 snippet，例如：

pm.test("Status code is 200", function () {
    pm.response.to.have.status(200);
});

pm.test("Response has user id", function () {
    var jsonData = pm.response.json();
    pm.expect(jsonData.id).to.exist;
});

Pre-request Script 则在请求发送前执行，常用来动态生成时间戳、签名 token、随机数等参数。

Mock Server

Postman 可以基于 Collection 自动生成 Mock Server，对外提供模拟响应。这样前端开发不需要等后端接口就绪就能联调，对外演示 Demo 时也避免依赖真实后端。Mock 规则可以通过 Examples 配置，每个 Request 可以添加多个 Example，对应不同的响应样本。

API 文档

发布 Collection 之后，Postman 会自动生成可访问的 Web 文档页面，包含每个接口的描述、参数说明、示例请求和示例响应。文档支持自定义主题、域名（付费功能），适合作为团队内部或对外公开的 API 参考。

免费额度与付费方案

Postman 采用 Freemium 模式，免费版已经能满足个人开发者和小型团队的大部分需求，但部分协作与高级能力需要付费。具体定价策略随时可能调整，建议以 Postman 官网定价页为准，下面仅描述功能层级的大致区分：

如果只是日常调试接口和写一些测试，免费版完全够用。一旦需要多人协作、API 监控、细粒度权限管理，就该考虑升级。

典型适用场景

Postman 不是只能用来手敲请求，它在以下几个场景里被高频使用：

1. 接口调试：开发新接口时快速验证返回结构是否符合预期。
2. 联调沟通：把构造好的请求直接通过 “Share” 功能发给同事，对方一键导入即可复现。
3. 自动化测试：通过 Collection Runner 批量执行一组接口，配合 Tests 脚本做回归。
4. API 文档管理：把 Collection 公开成文档，避免 Word/Markdown 文档与实际接口脱节。
5. CI/CD 集成：通过 Newman 在流水线里运行 Collection，作为部署前的冒烟测试。
6. 线上监控：定时调度关键接口，异常时告警（付费功能）。

进阶用法：把 Postman 接入工程化流程

Pre-request Script 与 Tests 脚本

Pre-request Script 在请求前执行，适合生成动态参数，例如签名校验中常见的时间戳 + 哈希。Tests 脚本在响应返回后执行，除了断言还能把响应里的字段提取出来，写入到环境变量，供后续请求使用。

Newman：命令行运行器

Newman 是 Postman 官方提供的命令行工具，本质上是对 Collection Runner 的封装，可以脱离 GUI 在终端或服务器里运行 Collection。典型用法：

# 安装 Newman
npm install -g newman

# 运行 Collection
newman run my-collection.json

# 指定环境变量文件
newman run my-collection.json -e dev-env.json

# 输出 JUnit 报告，便于 CI 集成
newman run my-collection.json -r junit --reporter-junit-export report.xml

Newman 让 Postman 的测试用例可以无缝嵌入 Jenkins、GitHub Actions、GitLab CI 等流水线。

Monitors（监控）

Postman 的 Monitor 功能会按设定的频率（每 5 分钟、每小时、每天等）自动运行一组 Collection，把响应结果记录下来，异常时通过邮件或 Webhook 通知。免费版的监控频率和次数有限制，付费版可以提升配额。

CI/CD 集成

把 Newman 嵌到 CI 流程里，是很多团队的做法：在每次合并代码前自动跑一遍关键接口，作为一道质量门禁。如果接口契约被破坏（字段被删除、状态码变更），CI 就会失败，及时暴露问题。

与开源替代品的对比

虽然 Postman 功能完善，但它是闭源商业产品，且团队协作、监控等功能门槛较高。如果你偏好开源，或者预算有限，可以考虑下面几个替代品。

Hoppscotch

Hoppscotch（项目主页 hoppscotch.io）是开源 API 开发生态，定位和 Postman 类似，但额外支持 WebSocket、Server-Sent Events、Socket.IO、MQTT、GraphQL 等多种协议，UI 也更轻量。它支持安装为 PWA、离线使用，可作为浏览器扩展缓解 CORS 问题，自带 Proxy 服务（proxyscotch）用于隐藏 IP 和访问 HTTP 端点。授权方式上支持 GitHub、Google、Microsoft、邮箱登录，企业版可启用 SSO。生态里还有官方 CLI、浏览器扩展等附加组件。License 为 MIT，可自托管。

Insomnia

Insomnia 同样是流行的开源 API 客户端，以界面简洁、支持 GraphQL 与 gRPC 见长。它有免费版和团队版，团队版增加了云同步、端到端加密、环境共享等能力。Insomnia 的插件机制允许通过插件扩展功能，适合需要在 Postman 之外寻找替代方案的用户。

对比维度一览

> 选型建议：个人或小团队、追求功能完备性 → Postman；预算有限、喜欢轻量开源、且需要多协议支持 → Hoppscotch；偏重 GraphQL/gRPC、UI 极简 → Insomnia。

写在最后

Postman 之所以成为 API 开发的”标配”，在于它把零散的工具整合成了统一的工作流：从设计到调试、从测试到文档、从单人开发到团队协作，都能在同一个平台完成。但工具始终服务于需求，如果你的项目对开源、成本或特定协议有要求，Hoppscotch、Insomnia 等替代品也值得尝试。

无论选择哪一款，核心思路都一样：把 API 视为一等公民来管理——版本化、可测试、可监控、可协作。这才是工具背后真正值得投入精力的方向。