Postman 完全入门教程

Postman 完全入门教程

Postman 是目前最流行的 API 开发、测试与文档协作工具，适用于开发者、测试工程师和产品经理。本教程从 零基础 开始，带你快速掌握 Postman 桌面版（v11+）的核心功能。

---

一、安装与准备

1. 下载安装

• 官网地址：https://www.postman.com/downloads/
• 选择 Windows / macOS / Linux 对应版本
• 安装后打开，建议登录账号（免费注册），便于云同步

小贴士：不登录也能用，但无法同步到云端，切换设备会丢失数据。

---

二、界面速览

打开 Postman 后，主界面分为：

区域	功能
左侧侧边栏	Collections、APIs、Environments、History
顶部标签页	每个请求一个 Tab
主工作区	请求构建区 + 响应查看区
底部状态栏	网络、代理、设置

---

三、发送你的第一个请求

步骤 1：创建请求

1. 点击左侧 Collections → + New Collection → 命名为 Demo API
2. 在集合内点击 Add a request
3. 填写：
   • Request name: GET Weather
   • Select method: GET
   • Enter URL: https://httpbin.org/get

步骤 2：发送请求

点击蓝色 Send 按钮

步骤 3：查看响应

下方会出现：

• Status: 200 OK
• Time: 响应时间
• Body: JSON 数据
• Headers / Cookies / Tests

恭喜！你已成功发送第一个 API 请求！

---

四、核心功能详解

1. 请求方法与参数

方法	用途
GET	获取数据
POST	提交数据
PUT / PATCH	更新数据
DELETE	删除数据

添加 Query 参数

text

https://httpbin.org/get?name=张三&age=18

或在 Params 标签中填写：

KEY	VALUE
name	张三
age	18

---

2. 请求体（Body）

用于 POST/PUT 请求，常见格式：

raw → JSON

json

{
  "username": "admin",
  "password": "123456"
}

form-data（上传文件）

• 点击 form-data
• Key 填 file，类型选 File，选择本地文件

x-www-form-urlencoded

text

username=admin&password=123456

---

3. 请求头（Headers）

点击 Headers 标签添加：

Key	Value
Content-Type	application/json
Authorization	Bearer your-token-here

小技巧：常用头可保存到集合中，避免重复填写。

---

4. 环境变量（Environments）

避免硬编码 URL，适合开发/测试/生产切换。

创建环境

1. 顶部下拉 → Manage Environments → Add

2. 填写：

   Variable	Initial Value	Current Value
   base_url	https://api.dev.com	https://api.test.com
   token	abc123	(留空，运行时填)

在请求中使用

text

{{base_url}}/users

双大括号 {{}} 是变量语法

---

5. 测试脚本（Tests）

在 Tests 标签写 JavaScript，自动验证响应。

javascript

// 检查状态码
pm.test("Status code is 200", function () {
    pm.response.to.have.status(200);
});

// 检查响应包含字段
pm.test("Response has name", function () {
    const json = pm.response.json();
    pm.expect(json.args.name).to.eql("张三");
});

// 设置环境变量（链式调用）
pm.environment.set("userId", pm.response.json().id);

运行后在 Test Results 查看通过/失败。

---

五、进阶功能

1. 集合运行器（Collection Runner）

批量执行多个请求：

1. 打开集合 → 点击 Runner
2. 选择环境 → 设置迭代次数 → Run
3. 查看整体报告

适合回归测试、数据初始化

---

2. 导入导出

导出集合

• 右键集合 → Export → 选 v2.1 格式
• 生成 .json 文件

导入

• Import → 拖入文件或粘贴链接（如 Swagger/OpenAPI）

---

3. Mock Server（模拟接口）

1. 集合 → Mock Server → 创建
2. 获取 mock URL：https://xxx.mock.postman.co
3. 前端可直接调用，无需后端

---

4. API 文档自动生成

1. 集合 → Generate Documentation
2. 填写描述 → 发布公开/团队链接
3. 支持 Markdown 预览

---

六、常见问题解决

问题	解决方案
打不开 / 白屏	清除缓存：%appdata%\Postman 删除文件夹
同步失败	检查网络，重新登录
中文乱码	Headers 加 Accept-Encoding: utf-8
代理失效	设置 → Proxy → 配置公司代理

---

七、学习资源

• 官方学习中心：https://learning.postman.com/
• 公共 API 测试：https://httpbin.org
• 模板市场：Postman → Templates 搜索 JSONPlaceholder

---

结语

掌握 Postman = 掌握 API 开发 80% 的效率！

建议你：

1. 建一个 "学习专用" 工作区
2. 每天用 Postman 调用 1 个真实接口
3. 写 1 条测试脚本

实战出真知，30 分钟上手，3 天精通！

---

附：快捷键（Windows/macOS）

操作	快捷键
发送请求	Ctrl+Enter
新建请求	Ctrl+T
搜索	Ctrl+F
美化 JSON	Ctrl+Alt+B