Postman使用教程：三步完成首次请求与团队协作配置

无论你是前端对接后端接口，还是测试人员验证API返回，Postman都能让请求调试变得直观。本教程跳过理论铺垫，直接带你完成三个核心任务：装好工具、发出请求、解决常见卡点。

下载与安装：选对版本避免兼容性问题

访问postman.com/downloads，根据系统选择安装包。Windows用户建议下载64位exe安装版而非便携版，后者在企业网络环境下可能触发安全策略拦截。macOS用户若使用Apple Silicon芯片（M1/M2/M3），务必选择ARM64版本，否则会通过Rosetta转译运行导致性能下降30%以上。安装后首次启动需注册账号，可选择跳过并使用Scratch Pad离线模式，但无法同步数据到云端。v10.18版本起，Postman强制要求登录才能使用Collection功能，若需完全离线使用，可保留v9.31.0旧版本。安装路径默认在C:\Users\[用户名]\AppData\Local\Postman，占用约500MB空间。

发送第一个请求：GET方法与响应解读

点击左侧New按钮创建HTTP Request，在地址栏输入https://jsonplaceholder.typicode.com/posts/1，方法选择GET，点击Send。正常情况下右侧会在200ms内返回JSON数据，Status显示200 OK。若显示Could not get any response，先检查网络连接，再打开Settings→Proxy，关闭Use the system proxy或手动设置代理地址。企业内网用户常遇到此问题，需在代理服务器字段填入公司提供的地址如proxy.company.com:8080。响应面板下方有Body、Cookies、Headers三个标签，Body展示返回内容，Headers可查看Content-Type是否为application/json。若返回HTML而非JSON，说明请求地址错误或服务端未正确配置路由。

环境变量配置：一套接口适配多环境

点击右上角眼睛图标打开Environments面板，新建环境命名为Dev，添加变量base_url，Initial Value填入https://dev-api.example.com，Current Value保持一致。再创建Prod环境，base_url改为https://api.example.com。在请求地址栏将完整URL改为{{base_url}}/users，切换环境后请求会自动指向不同服务器。团队协作时，Initial Value会同步到云端供他人查看，Current Value仅本地生效，可用于存储个人token避免泄露。v10.15版本后支持Secret类型变量，勾选后值会加密存储，适合保存API Key。若变量未生效显示{{base_url}}原样输出，检查环境是否已在右上角下拉菜单中激活，未激活的环境变量不会被解析。

团队协作与数据迁移：Workspace与导入导出

点击左上角Workspaces下拉菜单，选择Create Workspace，类型选Team可邀请成员协作，Personal仅自己可见。将Collection拖入Team Workspace后，成员修改请求会实时同步，右下角显示Synced标识。若需从Insomnia迁移，导出其JSON文件，在Postman中点击Import→Upload Files，选择导出的文件即可自动转换。注意Insomnia的环境变量需手动重建，因两者数据结构不兼容。导出Collection时选择v2.1格式保证兼容性，v2.0格式不支持Authorization继承。免费账户最多创建3个Team Workspace，超出需升级到Basic方案（每月9美元）。若团队规模超过10人，建议使用Enterprise版本的Private API Network功能集中管理接口文档。

常见问题

为什么请求一直转圈超过30秒没响应？

先检查Settings→General中Request timeout设置，默认0表示无限等，改为30000（30秒）。若仍超时，关闭Settings→Proxy中的代理或切换为系统代理。企业网络用户需在Proxy Bypass中添加localhost,127.0.0.1避免本地请求被代理拦截。部分杀毒软件会拦截Postman网络请求，临时关闭防火墙测试可排查此问题。

Collection Runner批量执行时部分请求失败怎么办？

打开Runner面板，勾选Save responses查看失败请求的详细返回。常见原因是前置请求未设置Tests脚本提取token，导致后续请求Authorization为空。在需要传递数据的请求Tests标签中添加pm.environment.set('token', pm.response.json().token)，后续请求Header中用{{token}}引用。若依赖关系复杂，调整Collection中请求顺序或使用postman.setNextRequest()控制执行流程。

如何把本地Collection同步给新入职同事？

将Collection移动到Team Workspace而非Personal Workspace，同事登录相同团队账号后自动可见。若对方无Postman账号，可右键Collection选择Export，发送JSON文件让其Import导入。注意环境变量需单独导出，点击环境右侧三点菜单选择Export，同事导入后需手动修改Current Value中的敏感信息如token。企业用户可使用API定义功能生成OpenAPI文档，通过链接分享无需安装Postman。

总结

立即访问postman.com下载最新版本，或查看官方Learning Center获取进阶教程与视频课程。

相关阅读：Postman使用教程，Postman使用教程使用技巧，Postman使用教程：新手必备的API环境配置与数据迁移实战指南