📌 第一部分：Postman 概览与定位

1.1 定义与全称

Postman 是由 Abhinav Asthana 于 2012 年创建的 API 开发和测试工具，是全球最流行的 API 工具。Postman 提供了直观的图形界面，让开发者可以 轻松发送 HTTP 请求、测试 API、管理环境变量、自动生成文档和执行自动化测试。

1.2 核心定位

Postman 的核心定位是 API 开发和测试的一体化平台。它提供了：

• 直观的 HTTP 请求构建器
• 环境变量和全局变量管理
• API 测试和断言
• 自动化测试（Collection Runner）
• API 文档自动生成
• 团队协作和版本控制
• Mock Server（模拟 API）
• API 监控和性能测试

1.3 主要应用领域

• API 开发： 快速测试和调试 API
• API 测试： 功能测试、集成测试、自动化测试
• API 文档： 自动生成文档供团队使用
• API 模拟： Mock Server 模拟 API 响应
• 性能测试： 负载测试和性能分析
• 团队协作： API 规范和文档共享
• CI/CD 集成： 自动化测试流水线

1.4 知名案例

• Google： 使用 Postman 测试 API
• Amazon： 使用 Postman 管理 API
• Twitter： 使用 Postman 测试 API
• Spotify： 使用 Postman 管理 API
• GitHub： 使用 Postman 测试 API
• 全球 2000 万+ 开发者： 使用 Postman

---

⚙️ 第二部分：核心功能

2.1 请求构建器

• HTTP 方法： GET、POST、PUT、PATCH、DELETE 等
• URL 参数： Query Params、Path Variables
• 请求头： Headers 自定义
• 请求体： form-data、x-www-form-urlencoded、JSON、XML、二进制
• 认证： API Key、Bearer Token、Basic Auth、OAuth 2.0
• 预请求脚本： 在请求发送前执行 JavaScript
• 测试脚本： 在响应返回后执行断言

2.2 环境管理

// 环境变量示例
{
    "base_url": "https://api.example.com",
    "api_key": "abc123def456",
    "user_id": "user_001",
    "access_token": "{{token}}"
}

// 在请求中使用变量
GET {{base_url}}/users/{{user_id}}
Authorization: Bearer {{access_token}}

// 在脚本中读取和设置变量
pm.environment.get("base_url")
pm.environment.set("access_token", response.token)
pm.globals.set("user_id", response.user.id)

2.3 测试脚本

// 测试脚本示例（在 "Tests" 标签中）
// 状态码验证
pm.test("状态码应为 200", function () {
    pm.response.to.have.status(200);
});

// 响应体验证
pm.test("响应体包含用户数据", function () {
    var jsonData = pm.response.json();
    pm.expect(jsonData).to.have.property("id");
    pm.expect(jsonData).to.have.property("name");
    pm.expect(jsonData.name).to.eql("Alice");
});

// 响应时间验证
pm.test("响应时间小于 500ms", function () {
    pm.expect(pm.response.responseTime).to.be.below(500);
});

// 数组验证
pm.test("用户列表包含数据", function () {
    var jsonData = pm.response.json();
    pm.expect(jsonData.data).to.be.an("array");
    pm.expect(jsonData.data.length).to.be.greaterThan(0);
});

// 提取变量（用于后续请求）
pm.test("提取用户 ID", function () {
    var jsonData = pm.response.json();
    pm.environment.set("user_id", jsonData.data[0].id);
});

2.4 Collection（集合）管理

• Collection： 组织多个请求
• 文件夹： 在 Collection 中分组
• Collection Runner： 批量运行所有请求
• 数据文件： 使用 CSV/JSON 数据驱动测试
• Collection 变量： 在 Collection 级别定义变量

2.5 自动化测试

# 使用 Newman 命令行运行 Collection
# 安装 Newman
npm install -g newman

# 运行 Collection
newman run collection.json -e environment.json

# 生成测试报告
newman run collection.json -r json --reporter-json-export report.json

# 集成 CI/CD
# Jenkinsfile / GitHub Actions / GitLab CI

2.6 API 文档生成

• 从 Collection 自动生成文档
• 支持 Markdown 描述
• 实时更新文档
• 支持示例代码
• 支持导出 HTML

---

⚖️ 第三部分：Postman vs 其他 API 工具

对比项	Postman	Insomnia	VS Code REST Client	Swagger
价格	免费/付费	免费	免费	免费/付费
图形界面	✅ 完善	✅ 完善	❌ 代码	✅
自动化测试	✅ 强大	✅ 基本	❌	❌
环境管理	✅ 完善	✅ 完善	✅ 基本	❌
文档生成	✅ 自动	✅ 基本	❌	✅ 完善
Mock Server	✅	❌	❌	✅
团队协作	✅ 完善	❌	❌	✅
适用场景	全能 API 工具	轻量 API 测试	开发者集成	API 设计文档

3.1 选择建议

• Postman： 全能 API 开发、测试、协作
• Insomnia： 轻量级 API 测试（GraphQL 支持更好）
• VS Code REST Client： 开发者集成环境
• Swagger： API 设计和文档

---

🧠 第四部分：学习建议

推荐学习资源

• Postman 官方文档： learning.postman.com
• Postman 学习中心： 视频教程
• Newman 文档： 命令行工具
• Postman 中文社区： 国内用户交流

---

🎯 总结升华