Postman使用指南:六个场景教你搞定接口调试

开篇
做开发、测试或者和后端打交道的人,都逃不开调接口这件事。接口一多,问题就来了:请求参数记不住、测试环境生产环境来回切、接口改了没人通知、联调时全靠聊天记录对来对去。
Postman 是解决这些问题的老牌工具,免费、跨平台,把"发请求"这件小事做成了完整的接口管理流程。这篇文章不讲原理,直接按六个常见场景演示怎么操作,装好 Postman 跟着一步步来就行。
场景一:发送第一个 GET 请求
需求:后端给了个接口 https://api.example.com/users,想看看返回什么。
操作步骤:
- 打开 Postman,左上角点 New → HTTP 请求
- 请求方式默认 GET,URL 栏填入
https://api.example.com/users - 点 Send
响应区会显示状态码、响应时间、响应体。JSON 响应自动格式化高亮,字段层级一目了然。
如果需要带查询参数,点 URL 栏下方的 Params 标签,按 key-value 填,Postman 会自动拼进 URL,不用手动改地址。
场景二:发送 POST 请求并携带 JSON
需求:登录接口,需要 POST 一个 JSON 请求体。
操作步骤:
- 新建请求,方式改为 POST
- URL 填登录接口地址
- 点 Body 标签,选择 raw,右侧格式选 JSON
- 在文本框里填请求体,比如
{"username":"admin","password":"123456"} - 点 Send
说明:Body 有多种格式——form-data(表单)、x-www-form-urlencoded(URL编码表单)、raw(JSON/XML/文本)、binary(文件上传)。调 REST 接口绝大多数用 raw + JSON。
场景三:环境变量切换测试/生产环境
需求:测试环境域名是 https://test-api.example.com,生产是 https://api.example.com,接口路径完全一样,不想每次手动改 URL。
操作步骤:
- 右上角齿轮图标 → 管理环境(Manage Environments)
- 点 Add,建一个"测试环境",添加变量
base_url=https://test-api.example.com - 再建一个"生产环境",
base_url=https://api.example.com - 请求 URL 写成
{{base_url}}/users - 右上角环境下拉切换,所有请求自动指向对应域名
说明:这就是 Postman 比 curl 省事的核心功能之一。token、用户ID这类经常变的值也可以抽成变量,改一处全集合生效。
场景四:集合管理接口 + 导出协作
需求:接口多了(几十个),想按模块分组;同事也要用,不想一个个口头传。
操作步骤:
- 左侧点 Collections → 新建集合,命名"用户模块"
- 把登录、获取用户、修改用户等请求分别"Save As"保存进集合
- 集合支持建文件夹(Folder),按功能再分组
- 需要给同事时,右键集合 → Export,导出 .json 文件
- 同事 Import 导入即可,接口配置、参数、脚本全部带过来
说明:集合是 Postman 的核心组织单位,本质是个 JSON 文件,可以直接进 Git 仓库版本管理。团队里最常见的协作方式是后端维护集合,前端和测试导入即用。
场景五:脚本断言 + 提取响应数据串联请求
需求:登录后拿到 token,后续请求的 Header 都要带这个 token,不能每次手动复制。
操作步骤:
- 登录请求的 Tests 标签页,写脚本提取 token 存入环境变量:
const body = pm.response.json();
pm.environment.set('token', body.token);
- 后续请求的 Header 里,Authorization 值填
Bearer {{token}} - 顺便加个断言,验证登录成功:
pm.test('状态码为200', function () {
pm.response.to.have.status(200);
});
- 点 Send,如果响应里有 token 字段,环境变量自动更新,后续请求自动带上
说明:这是接口联调的经典模式——响应数据传给下一个请求。写几个断言,一个请求集合就变成了可重复执行的冒烟测试集。
场景六:汉化与常见问题排查
需求:Postman 是英文界面,或者使用时遇到问题。
汉化步骤:
- 下载对应版本的汉化包,解压得到 app 文件夹
- 找到 Postman 安装目录(Windows 一般在
%LocalAppData%\Postman) - 用汉化包的 app 文件夹替换安装目录里的 app 文件夹
- 重启 Postman,界面变中文
常见问题排查:
| 问题 | 原因 | 解决 |
|---|---|---|
| 点击发送一直转圈 | 目标接口不可达/网络代理 | 浏览器先测能否直连;检查代理设置 |
| 报 Could not get any response | 服务器无响应/被网络层拦截 | 检查 URL、端口;本地接口确认服务已启动 |
| 汉化后打不开 | 版本不匹配/替换时未退出 | 关掉 Postman 重新替换,核对版本号 |
| 返回乱码 | 编码问题 | 检查响应 Content-Type 的 charset;调整 Postman 响应编码设置 |
| 接口地址要登录才能访问 | 接口带鉴权 | 配置 Auth(Bearer/Basic/OAuth),或手动加 Authorization 头 |
总结
Postman 的日常使用链路就这六个场景:
- 发请求:GET 带参数、POST 带 JSON
- 切环境:环境变量解决测试/生产域名切换
- 管接口:集合分组 + 导出导入协作
- 做自动化:脚本断言 + 响应数据提取串联
- 查问题:汉化 + 常见错误排查
核心思路一句话:把"发请求"变成"管接口"。接口不再散落在聊天记录和终端历史里,而是可复用、可分享、可验证的资产。
Postman **原版安装包支持 Windows/macOS/Linux,下载地址 postman-tools.ijinshan.com,免费版对个人开发者完全够用。

浙公网安备 33010602011771号