我第一次真正用明白Postman是在帮团队做接口联调的时候。在那之前我调试接口要么开浏览器直接敲URL要么让后端同事帮我打日志明明只是验证一个登录接口通不通却要来回折腾半天。认识Postman之后发请求、看响应、保存用例变成了一件特别顺手的事很多前后端之间的无谓扯皮到它这里直接就化解了。这个系列我打算从最基础的安装使用一路写到脚本断言、集合自动化、命令行执行。作为第一篇这篇文章只做两件事帮你把Postman装上再带你发第一个请求、保存第一组用例。内容适合刚接触接口调试的开发、测试同学也适合那些装了Postman但只会点Send的朋友。1. 安装之前先想清楚Postman到底帮你省了什么事1.1 没有Postman的时候接口调试有多痛现在的浏览器虽然自带调试工具但直接访问地址只适合GET请求。你想验证一个POST接口或者给请求加一个自定义Header浏览器地址栏就完全使不上劲了。于是很多人退回命令行拿curl去调。curl功能确实全但命令一长就难维护尤其是带一堆Header、Cookie、JSON体的时候写错一个引号整条命令就废了而且调完之后没有任何地方帮你保存这次调用记录。真正让我下定决心用Postman的是登录后带着token查列表这种场景。以前我要先从登录接口的响应里复制token再手动拼到下一个请求的Header里token一过期就得重复操作。Postman里可以用环境变量把token存起来后续请求自动带上。这个能力对日常联调来说不是锦上添花而是刚需要。它把发请求、看响应、存用例、管理参数这四件事放到了同一个界面里你不需要在浏览器、命令行、笔记软件之间来回切换。1.2 从浏览器扩展到独立客户端为什么值得单独装一个AppPostman最早是以浏览器扩展的形式出现的用起来确实轻便但后来逐渐暴露了几个硬伤浏览器有跨域限制有些接口响应无法完整读取存储空间和性能也受浏览器进程影响请求一多就卡。所以它早早就升级成了独立的桌面客户端能脱离浏览器运行处理更大的请求和响应也更适合长时间开着调试。现在Postman主要有三种形态桌面客户端日常开发调试的主力功能最全。Web版临时应急用功能少一些。命令行工具老手用来跑自动化测试适合持续集成流程。本篇只讲桌面客户端这也是绝大多数人需要装的那个。另外免费版对个人学习和中小项目完全够用集合数量、环境变量数量都没什么压力不需要一开始就纠结付费版。2. 三个平台的安装实操以及安装后要做的第一件事2.1 下载渠道和系统要求先说最容易出问题的地方下载我只认准一个渠道官网。现在搜索引擎里搜Postman前几页混着不少第三方下载站有些下载下来的安装包会捆绑额外程序装着装着电脑桌面就多了一排全家桶。官网下载通常会自动识别你的操作系统Windows给exemacOS给dmgLinux给对应的安装包认准它就不会翻车。系统要求方面Windows 10以上、macOS 10.15以上、主流Linux发行版基本都能跑。内存建议4GB以上Postman本身是Electron系的应用也就是用网页技术套壳的桌面应用启动后占的内存不算小内存紧张的老机器会很吃力。安装包体积也不小首次安装请耐心等进度条走完别中途关掉。另外我习惯把安装路径改成纯英文目录Windows环境下某些中文路径偶尔会引发莫名其妙的问题虽然不常见但没必要赌。2.2 Windows、macOS、Linux的安装步骤各说一遍Windows下载exe安装包双击运行。安装向导一路下一步即可建议在选路径那一步改成纯英文目录。安装完成后桌面会有快捷方式双击启动。如果系统弹出防火墙提醒勾选允许访问即可不然请求可能发不出去。双击没反应时先打开任务管理器看看进程是不是已经启动了有些时候主窗口被最小化到托盘并不是程序坏了。macOS打开下载好的dmg文件把Postman图标拖进Applications文件夹。首次打开如果提示无法验证开发者身份不用慌。去系统设置里的隐私与安全性找到对应提示点仍要打开。之后正常从启动台打开。LinuxDebian系发行版可以用sudo apt install ./postman-版本号.deb安装。rpm系发行版类似用sudo rpm -ivh 包名.rpm。如果下载的是AppImage格式给它执行权限再运行chmod x Postman.AppImage ./Postman.AppImage也可以从软件商店搜索安装但很多发行版的软件商店版本落后不建议。Linux下还有一个常见玩法是解压tar.gz直接运行里面的可执行文件这种方式不需要root权限适合没有管理权限的办公机器。2.3 首次启动登录、界面布局和两个值得调的小设置安装完第一次启动你会被挡在登录页。现在的Postman不登录进不去主界面所以注册一个账号是必须的。用邮箱注册即可注册完登录建议顺手把界面右上角的同步打开这样集合、环境变量会同步到云端换电脑或者重装系统都不心疼。进去之后先认三个区域左侧边栏最常用的是History历史请求和Collections集合下面还有Environments环境。中间主区域顶部是请求方法和URL输入框下方一排标签页包括Params、Headers、Body等。右侧区域响应区状态码、响应时间、返回内容都在这边。界面默认是英文目前没有完整的中文语言包。但你真正需要认识的单词不会超过二十个用几次就熟了没必要等汉化。进去之后我建议先做两个调整。第一个在Settings里把主题换成你顺眼的深色或浅色第二个找到Two pane view这个选项它控制请求区和响应区是左右分屏还是上下分屏。宽屏显示器用左右更舒服笔记本则适合上下布局。3. 第一次发请求从URL到响应的完整链路3.1 请求工作台里的每个部件是干什么的请求工作台看起来有点复杂其实拆开就五样东西。第一样是方法下拉框。GET、POST、PUT、PATCH、DELETE、HEAD、OPTIONS都在这。选对方法很重要后端路由都是按方法区分动作的你发错了直接给你404。第二样是URL输入框。直接输入带协议头的完整地址就行比如http://localhost:3000/api/users。我强烈建议大家把http://或https://写全虽然Postman会自动补全但它不知道你本地服务到底是http还是https自动猜可能猜错。第三样是Params标签。如果你在URL里写了问号参数比如http://localhost:3000/api/users?page1size20点进Params页签Postman会把page和size自动拆成一行行的键值对你直接改表格里的值URL会跟着同步更新。反过来你在表格里加一行URL也会自动拼上去。第四样是发送按钮旁边的一排功能钮。Save用来保存请求Code可以一键生成Java、Python、JavaScript等语言的请求代码这个功能后面写接口对接文档非常有用。第五样是URL输入框下面的几个标签。Headers用来加请求头Body用来放请求体Pre-request Script是发请求前执行的脚本Tests是收到响应后执行的脚本。本篇先知道有这两块区域具体怎么玩后面单独展开。认识完部件在本地启动一个接口Demo方法选GETURL填http://localhost:3000/api/users点Send。如果一切正常响应区会返回一串JSON数据。没返回也不要紧看状态码、看响应信息多半在下面几个坑里能对号入座。3.2 请求方法、Headers与Body的正确搭配HTTP方法选错是新人最容易犯的错。我按常用程度整理了一个表方法典型场景请求体GET查询列表、查询详情一般不需要POST创建资源、登录、提交数据需要PUT / PATCH更新资源需要DELETE删除资源可有可无HEAD / OPTIONS探测资源、查看接口支持的方法不需要注意一点Postman里GET请求也能写Body但绝大多数后端框架和浏览器请求都不会这么用平时不要这样干免得给自己和同事找麻烦。Headers这块核心是理解Content-Type它告诉后端你发的东西是什么格式。Postman很贴心当你在Body里选了raw的JSON格式它会自动在Headers里加上Content-Type: application/json。但如果你手动把Headers清掉了或者选了其他Body格式就得自己确认Content-Type对不对。Body的格式选择直接决定了后端能不能解析你的参数。Postman里常用这几种Body格式本质常见用途none不携带请求体GET、DELETEform-datamultipart/form-data既能传键值也能传文件文件上传、带图片的表单x-www-form-urlencoded普通表单键值对扁平结构传统网页表单raw自定义文本可切换JSON/XML/Text前后端联调最常见binary直接上传二进制文件文件流接口实际联调中我几乎只用raw里的JSON格式。原因很简单JSON能表达嵌套结构类型明确绝大多数后端框架原生支持而且Postman会自动帮你带好Content-Type。来个例子本地登录接口Demo方法选POSTURL填http://localhost:3000/api/loginBody选raw右侧格式选JSON填入{ username: test01, password: 123456 }点Send正常会返回token和用户信息。这个操作看起来简单却是后面所有自动化操作的地基。3.3 响应区怎么读状态码、时间、大小和三种视图点完Send右侧响应区会刷新第一眼先看状态码。Postman用颜色帮你做了区分2xx显示绿色表示成功3xx黄色表示重定向4xx橙红色比如404、4015xx红色表示服务端出错。这个颜色编码很直观一眼就能判断这次请求是正常还是有问题。状态码下面的Time和Size很有用。Time表示从发出请求到收到完整响应的时间用来粗估接口性能一般200毫秒内算不错超过1秒就要留意了。Size是响应体积如果接口动不动返回几MB数据前端页面加载肯定会慢这时候就得让后端该瘦身的瘦身。进入Body内部有三种视图Pretty格式化后的JSON带缩进和语法高亮日常看这个最多。Raw原始报文不带任何格式化适合排查问题比如看报文里是不是混入了特殊字符。Preview像浏览器一样渲染HTML或图片遇到返回网页内容的接口用得上。响应区下方通常还有Headers和Cookies标签可以查看响应头里的Content-Type、Set-Cookie等关键信息。刚上手时不用全看重点是先习惯状态码、时间、JSON格式化三件套。顺手提一句快捷键CtrlEnter发送请求CtrlS保存请求CtrlT新建标签这几个高频操作值得记一下。4. Collections与Environments从单次调用变成可复用的接口资产4.1 集合的层级逻辑请求不再是临时草稿发出去一个请求只是开始如果你每次调接口都要重新敲一遍URL和参数那Postman也只是个好看点的命令行。真正有价值的操作是把请求保存进集合Collections。操作很简单请求构造好之后点Save弹窗里让你选择保存到哪个集合也可以现场新建一个。我建议按项目或者业务模块来建集合比如建一个接口Demo集合里面再按登录、用户、商品建子文件夹请求命名也带上语义比如登录-获取token用户列表-按关键词搜索。这样过了三个月回来看你还能一眼找到当初调的接口。集合至少带来三个价值复用、组织、分享。复用就是双击请求就能再次发送不用重敲。组织就是分层级管理整个项目的接口一目了然。分享更实用右键集合选Export导出的JSON格式是Collection v2.1这也是行业里通用的接口集合格式别人拿到这个JSON文件直接在Postman里Import就能看到全部请求。还可以通过工作空间Workspace邀请成员共用集合大家在同一个集合里维护接口比发来发去Word接口文档强太多了。4.2 环境变量与全局变量告别手改URL用了一段时间Postman你一定会遇到这种场景本地联调用的地址是http://localhost:3000测试环境用的又是http://test.example.com每次切换环境都要把URL里的域名手动改一遍改错一个字符就白调半天。环境变量就是干这个的。打开左侧的Environments新建一个环境取名本地开发添加一个变量baseUrl值填http://localhost:3000。然后在URL输入框里改成{{baseUrl}}/api/users。这样当你顶部环境选择下拉框选中本地开发时Postman会自动把它解析成http://localhost:3000/api/users。再建一个测试环境同样定义baseUrl值填http://test.example.com。切换下拉框同样的请求自动发到不同地址URL模板一个字符都不用改。这就是变量替换的威力。变量不仅仅能用在URLHeaders、Body、脚本里都能引用规则都是花括号双写。除了环境变量还有一组全局变量Globals。环境变量按环境切分组管理全局变量则对所有环境生效。我的习惯是会随环境变化的配置放环境变量比如服务器地址、账号绝对不变的东西放全局变量比如默认分页大小。这里要提醒一个细节环境变量有两列Initial value和Current value。初始值会随环境配置一起被导出、分享适合放不敏感的基础配置当前值只存在你本地适合放token这类临时数据不会一同步就暴露给队友。4.3 串联实操登录后token自动写入环境变量前面提到的登录后带token查列表正是环境变量最经典用法。登录接口Demo返回的token通常是动态的手工复制粘一次两次还行token一过期就要重复劳动。在登录请求的Tests标签里写入这样一段脚本const resp pm.response.json(); if (resp resp.token) { pm.environment.set(token, resp.token); }这段脚本的意思很简单请求完成后把响应体解析成JSON对象如果里面有token字段就把它存进当前环境的token变量。先发一次登录请求然后打开环境变量面板你会发现token变量已经被自动填上了真实值。接下来查询用户列表请求的Headers里加一个键Authorization值填{{token}}。以后不管token怎么变化你只需要先发登录请求再发列表请求系统自动完成传参。这一小段代码背后涉及的Pre-request Script、Tests脚本详细语法我后面会专门开一篇慢慢讲本篇文章你先把用法记住它值得你反复练几遍。5. 新手阶段最真实的五个坑以及我怎么绕过去的5.1 不登录连窗口都进不去这不是软件坏了不少同事第一次装完Postman双击之后发现一直停在登录页第一反应是自己安装失败或者又碰上必须破解才能用的规矩于是去网上找各种绿色版、破解版。其实完全没必要。Postman把账号体系做进了产品里不登录就是进不去这是设计如此不是电脑坏了。解决办法很简单注册一个账号正常登录。如果所在网络访问不畅可以考虑等待网络恢复后再同步不要下载来路不明的改版安装包。那些所谓离线版本质上是被篡改过的程序运行起来没有任何安全保证为了省一个邮箱注册步骤把自己的电脑和数据暴露在风险里不值得。5.2 Body发过去后端读空值先查Content-Type这是我见过最多的求助问题明明POST了一个JSON后端一打印全是undefined。排查链路其实很清楚——先看Postman的Headers标签里Content-Type到底是什么再看Body标签里实际选了什么格式。如果Body选的是raw但右侧格式没切到JSON发送出去的Content-Type就是text/plain。后端框架一看不是application/json干脆把请求体当成普通文本你填的键值对它根本解析不出来。解决办法就是Body选raw右侧格式点一下JSON让Postman自动把Content-Type改成application/json。排查时还可以点开底部栏里的Console按钮查看实际发出的原始报文里面能看到真实的Content-Type到底长什么样。这个报文献不会骗人。5.3 本地https自签名报证书错误这样处理在本地做联调时项目可能启动在https://localhost:8443用的是自签名证书。Postman默认会校验证书遇到不在受信列表里的证书直接报类似证书校验失败的错或者干脆显示Could not get response。我第一次遇到时以为是地址写错了反复检查端口和路径后来才反应过来是证书信任问题。处理方式是在Settings里找到SSL certificate verification把它临时关掉。但这里必须划重点这个选项只建议在本地开发环境关闭。生产环境、涉及真实用户数据的接口一定要保持校验开启否则中间人攻击的风险完全暴露在网络上。排查顺序建议是先确认服务真的起来了端口、路径没拼错再考虑是不是自签名证书问题最后看日志确认服务端有没有收到请求。按照这个顺序走大部分请求失败都能在几分钟内找到原因。5.4 集合改动丢失自动保存不是万能保险现在的Postman版本对集合有了自动保存机制改完请求它自己会存基本不需要手动CtrlS。但这不代表你可以随便造。如果你在离线状态下改了集合然后通过任务管理器强行结束进程某些改动可能没写盘就丢了。更麻烦的是离开登录状态时本机改动和云端同步会发生冲突有时候你改的版本会被新版本覆盖。我现在的习惯是两个保险并用。第一保持登录并联网让改动实时进入云端同步。第二给重要集合定期右键Export把JSON文件当作备份存一份到网盘或者代码仓库里。别嫌麻烦等你辛辛苦苦配了五六十个请求后发现一夜回到解放前那才叫崩溃。5.5 中文变成\uXXXX或乱码是转义不是错有段时间我特别疑惑明明响应里中文显示得好好的怎么一复制就变成\u4e2d\u6587这种形式后来才搞明白这是JSON标准允许的Unicode转义很多后端框架在序列化时会默认把中文转成\uXXXX编码发出。它不是乱码也不是数据损坏你在Pretty视图里会正常显示中文复制到别处就还原成转义序列因为这是数据最原始的样子完全不必要在客户端处理。真正要警惕的是中文直接显示成锟斤拷或一堆问号。这种情况大多是因为响应头里的Content-Type没有带charsetutf-8客户端拿UTF-8去解析GBK编码的返回自然会花屏。这种问题爹不疼娘不爱后端加个响应头就能解决你改不了后端的话至少在排错时能定位到是编码声明的锅。我在实际使用中的体会是Postman这类工具最大的价值不只是发请求而是让人把接口当作可积累的资产来管理。先把它装上跑通一个登录接口存进集合用环境变量把地址和token管起来。这一步一旦走通后面再学脚本、断言、自动化Runner都会非常顺。下一篇我准备专门写Pre-request Script和Tests的常用脚本模式把自动登录、参数关联这些玩法一次性展开。如果你在安装或发第一个请求时就卡住了把这几个坑对照查一遍基本都能解决。 
长河君 · 2026/10/20 21:59:58 · 阅读 1.2k Postman安装与首次请求：从接口调试到集合与环境变量的实战入门
我第一次真正用明白Postman是在帮团队做接口联调的时候。在那之前我调试接口要么开浏览器直接敲URL要么让后端同事帮我打日志明明只是验证一个登录接口通不通却要来回折腾半天。认识Postman之后发请求、看响应、保存用例变成了一件特别顺手的事很多前后端之间的无谓扯皮到它这里直接就化解了。这个系列我打算从最基础的安装使用一路写到脚本断言、集合自动化、命令行执行。作为第一篇这篇文章只做两件事帮你把Postman装上再带你发第一个请求、保存第一组用例。内容适合刚接触接口调试的开发、测试同学也适合那些装了Postman但只会点Send的朋友。1. 安装之前先想清楚Postman到底帮你省了什么事1.1 没有Postman的时候接口调试有多痛现在的浏览器虽然自带调试工具但直接访问地址只适合GET请求。你想验证一个POST接口或者给请求加一个自定义Header浏览器地址栏就完全使不上劲了。于是很多人退回命令行拿curl去调。curl功能确实全但命令一长就难维护尤其是带一堆Header、Cookie、JSON体的时候写错一个引号整条命令就废了而且调完之后没有任何地方帮你保存这次调用记录。真正让我下定决心用Postman的是登录后带着token查列表这种场景。以前我要先从登录接口的响应里复制token再手动拼到下一个请求的Header里token一过期就得重复操作。Postman里可以用环境变量把token存起来后续请求自动带上。这个能力对日常联调来说不是锦上添花而是刚需要。它把发请求、看响应、存用例、管理参数这四件事放到了同一个界面里你不需要在浏览器、命令行、笔记软件之间来回切换。1.2 从浏览器扩展到独立客户端为什么值得单独装一个AppPostman最早是以浏览器扩展的形式出现的用起来确实轻便但后来逐渐暴露了几个硬伤浏览器有跨域限制有些接口响应无法完整读取存储空间和性能也受浏览器进程影响请求一多就卡。所以它早早就升级成了独立的桌面客户端能脱离浏览器运行处理更大的请求和响应也更适合长时间开着调试。现在Postman主要有三种形态桌面客户端日常开发调试的主力功能最全。Web版临时应急用功能少一些。命令行工具老手用来跑自动化测试适合持续集成流程。本篇只讲桌面客户端这也是绝大多数人需要装的那个。另外免费版对个人学习和中小项目完全够用集合数量、环境变量数量都没什么压力不需要一开始就纠结付费版。2. 三个平台的安装实操以及安装后要做的第一件事2.1 下载渠道和系统要求先说最容易出问题的地方下载我只认准一个渠道官网。现在搜索引擎里搜Postman前几页混着不少第三方下载站有些下载下来的安装包会捆绑额外程序装着装着电脑桌面就多了一排全家桶。官网下载通常会自动识别你的操作系统Windows给exemacOS给dmgLinux给对应的安装包认准它就不会翻车。系统要求方面Windows 10以上、macOS 10.15以上、主流Linux发行版基本都能跑。内存建议4GB以上Postman本身是Electron系的应用也就是用网页技术套壳的桌面应用启动后占的内存不算小内存紧张的老机器会很吃力。安装包体积也不小首次安装请耐心等进度条走完别中途关掉。另外我习惯把安装路径改成纯英文目录Windows环境下某些中文路径偶尔会引发莫名其妙的问题虽然不常见但没必要赌。2.2 Windows、macOS、Linux的安装步骤各说一遍Windows下载exe安装包双击运行。安装向导一路下一步即可建议在选路径那一步改成纯英文目录。安装完成后桌面会有快捷方式双击启动。如果系统弹出防火墙提醒勾选允许访问即可不然请求可能发不出去。双击没反应时先打开任务管理器看看进程是不是已经启动了有些时候主窗口被最小化到托盘并不是程序坏了。macOS打开下载好的dmg文件把Postman图标拖进Applications文件夹。首次打开如果提示无法验证开发者身份不用慌。去系统设置里的隐私与安全性找到对应提示点仍要打开。之后正常从启动台打开。LinuxDebian系发行版可以用sudo apt install ./postman-版本号.deb安装。rpm系发行版类似用sudo rpm -ivh 包名.rpm。如果下载的是AppImage格式给它执行权限再运行chmod x Postman.AppImage ./Postman.AppImage也可以从软件商店搜索安装但很多发行版的软件商店版本落后不建议。Linux下还有一个常见玩法是解压tar.gz直接运行里面的可执行文件这种方式不需要root权限适合没有管理权限的办公机器。2.3 首次启动登录、界面布局和两个值得调的小设置安装完第一次启动你会被挡在登录页。现在的Postman不登录进不去主界面所以注册一个账号是必须的。用邮箱注册即可注册完登录建议顺手把界面右上角的同步打开这样集合、环境变量会同步到云端换电脑或者重装系统都不心疼。进去之后先认三个区域左侧边栏最常用的是History历史请求和Collections集合下面还有Environments环境。中间主区域顶部是请求方法和URL输入框下方一排标签页包括Params、Headers、Body等。右侧区域响应区状态码、响应时间、返回内容都在这边。界面默认是英文目前没有完整的中文语言包。但你真正需要认识的单词不会超过二十个用几次就熟了没必要等汉化。进去之后我建议先做两个调整。第一个在Settings里把主题换成你顺眼的深色或浅色第二个找到Two pane view这个选项它控制请求区和响应区是左右分屏还是上下分屏。宽屏显示器用左右更舒服笔记本则适合上下布局。3. 第一次发请求从URL到响应的完整链路3.1 请求工作台里的每个部件是干什么的请求工作台看起来有点复杂其实拆开就五样东西。第一样是方法下拉框。GET、POST、PUT、PATCH、DELETE、HEAD、OPTIONS都在这。选对方法很重要后端路由都是按方法区分动作的你发错了直接给你404。第二样是URL输入框。直接输入带协议头的完整地址就行比如http://localhost:3000/api/users。我强烈建议大家把http://或https://写全虽然Postman会自动补全但它不知道你本地服务到底是http还是https自动猜可能猜错。第三样是Params标签。如果你在URL里写了问号参数比如http://localhost:3000/api/users?page1size20点进Params页签Postman会把page和size自动拆成一行行的键值对你直接改表格里的值URL会跟着同步更新。反过来你在表格里加一行URL也会自动拼上去。第四样是发送按钮旁边的一排功能钮。Save用来保存请求Code可以一键生成Java、Python、JavaScript等语言的请求代码这个功能后面写接口对接文档非常有用。第五样是URL输入框下面的几个标签。Headers用来加请求头Body用来放请求体Pre-request Script是发请求前执行的脚本Tests是收到响应后执行的脚本。本篇先知道有这两块区域具体怎么玩后面单独展开。认识完部件在本地启动一个接口Demo方法选GETURL填http://localhost:3000/api/users点Send。如果一切正常响应区会返回一串JSON数据。没返回也不要紧看状态码、看响应信息多半在下面几个坑里能对号入座。3.2 请求方法、Headers与Body的正确搭配HTTP方法选错是新人最容易犯的错。我按常用程度整理了一个表方法典型场景请求体GET查询列表、查询详情一般不需要POST创建资源、登录、提交数据需要PUT / PATCH更新资源需要DELETE删除资源可有可无HEAD / OPTIONS探测资源、查看接口支持的方法不需要注意一点Postman里GET请求也能写Body但绝大多数后端框架和浏览器请求都不会这么用平时不要这样干免得给自己和同事找麻烦。Headers这块核心是理解Content-Type它告诉后端你发的东西是什么格式。Postman很贴心当你在Body里选了raw的JSON格式它会自动在Headers里加上Content-Type: application/json。但如果你手动把Headers清掉了或者选了其他Body格式就得自己确认Content-Type对不对。Body的格式选择直接决定了后端能不能解析你的参数。Postman里常用这几种Body格式本质常见用途none不携带请求体GET、DELETEform-datamultipart/form-data既能传键值也能传文件文件上传、带图片的表单x-www-form-urlencoded普通表单键值对扁平结构传统网页表单raw自定义文本可切换JSON/XML/Text前后端联调最常见binary直接上传二进制文件文件流接口实际联调中我几乎只用raw里的JSON格式。原因很简单JSON能表达嵌套结构类型明确绝大多数后端框架原生支持而且Postman会自动帮你带好Content-Type。来个例子本地登录接口Demo方法选POSTURL填http://localhost:3000/api/loginBody选raw右侧格式选JSON填入{ username: test01, password: 123456 }点Send正常会返回token和用户信息。这个操作看起来简单却是后面所有自动化操作的地基。3.3 响应区怎么读状态码、时间、大小和三种视图点完Send右侧响应区会刷新第一眼先看状态码。Postman用颜色帮你做了区分2xx显示绿色表示成功3xx黄色表示重定向4xx橙红色比如404、4015xx红色表示服务端出错。这个颜色编码很直观一眼就能判断这次请求是正常还是有问题。状态码下面的Time和Size很有用。Time表示从发出请求到收到完整响应的时间用来粗估接口性能一般200毫秒内算不错超过1秒就要留意了。Size是响应体积如果接口动不动返回几MB数据前端页面加载肯定会慢这时候就得让后端该瘦身的瘦身。进入Body内部有三种视图Pretty格式化后的JSON带缩进和语法高亮日常看这个最多。Raw原始报文不带任何格式化适合排查问题比如看报文里是不是混入了特殊字符。Preview像浏览器一样渲染HTML或图片遇到返回网页内容的接口用得上。响应区下方通常还有Headers和Cookies标签可以查看响应头里的Content-Type、Set-Cookie等关键信息。刚上手时不用全看重点是先习惯状态码、时间、JSON格式化三件套。顺手提一句快捷键CtrlEnter发送请求CtrlS保存请求CtrlT新建标签这几个高频操作值得记一下。4. Collections与Environments从单次调用变成可复用的接口资产4.1 集合的层级逻辑请求不再是临时草稿发出去一个请求只是开始如果你每次调接口都要重新敲一遍URL和参数那Postman也只是个好看点的命令行。真正有价值的操作是把请求保存进集合Collections。操作很简单请求构造好之后点Save弹窗里让你选择保存到哪个集合也可以现场新建一个。我建议按项目或者业务模块来建集合比如建一个接口Demo集合里面再按登录、用户、商品建子文件夹请求命名也带上语义比如登录-获取token用户列表-按关键词搜索。这样过了三个月回来看你还能一眼找到当初调的接口。集合至少带来三个价值复用、组织、分享。复用就是双击请求就能再次发送不用重敲。组织就是分层级管理整个项目的接口一目了然。分享更实用右键集合选Export导出的JSON格式是Collection v2.1这也是行业里通用的接口集合格式别人拿到这个JSON文件直接在Postman里Import就能看到全部请求。还可以通过工作空间Workspace邀请成员共用集合大家在同一个集合里维护接口比发来发去Word接口文档强太多了。4.2 环境变量与全局变量告别手改URL用了一段时间Postman你一定会遇到这种场景本地联调用的地址是http://localhost:3000测试环境用的又是http://test.example.com每次切换环境都要把URL里的域名手动改一遍改错一个字符就白调半天。环境变量就是干这个的。打开左侧的Environments新建一个环境取名本地开发添加一个变量baseUrl值填http://localhost:3000。然后在URL输入框里改成{{baseUrl}}/api/users。这样当你顶部环境选择下拉框选中本地开发时Postman会自动把它解析成http://localhost:3000/api/users。再建一个测试环境同样定义baseUrl值填http://test.example.com。切换下拉框同样的请求自动发到不同地址URL模板一个字符都不用改。这就是变量替换的威力。变量不仅仅能用在URLHeaders、Body、脚本里都能引用规则都是花括号双写。除了环境变量还有一组全局变量Globals。环境变量按环境切分组管理全局变量则对所有环境生效。我的习惯是会随环境变化的配置放环境变量比如服务器地址、账号绝对不变的东西放全局变量比如默认分页大小。这里要提醒一个细节环境变量有两列Initial value和Current value。初始值会随环境配置一起被导出、分享适合放不敏感的基础配置当前值只存在你本地适合放token这类临时数据不会一同步就暴露给队友。4.3 串联实操登录后token自动写入环境变量前面提到的登录后带token查列表正是环境变量最经典用法。登录接口Demo返回的token通常是动态的手工复制粘一次两次还行token一过期就要重复劳动。在登录请求的Tests标签里写入这样一段脚本const resp pm.response.json(); if (resp resp.token) { pm.environment.set(token, resp.token); }这段脚本的意思很简单请求完成后把响应体解析成JSON对象如果里面有token字段就把它存进当前环境的token变量。先发一次登录请求然后打开环境变量面板你会发现token变量已经被自动填上了真实值。接下来查询用户列表请求的Headers里加一个键Authorization值填{{token}}。以后不管token怎么变化你只需要先发登录请求再发列表请求系统自动完成传参。这一小段代码背后涉及的Pre-request Script、Tests脚本详细语法我后面会专门开一篇慢慢讲本篇文章你先把用法记住它值得你反复练几遍。5. 新手阶段最真实的五个坑以及我怎么绕过去的5.1 不登录连窗口都进不去这不是软件坏了不少同事第一次装完Postman双击之后发现一直停在登录页第一反应是自己安装失败或者又碰上必须破解才能用的规矩于是去网上找各种绿色版、破解版。其实完全没必要。Postman把账号体系做进了产品里不登录就是进不去这是设计如此不是电脑坏了。解决办法很简单注册一个账号正常登录。如果所在网络访问不畅可以考虑等待网络恢复后再同步不要下载来路不明的改版安装包。那些所谓离线版本质上是被篡改过的程序运行起来没有任何安全保证为了省一个邮箱注册步骤把自己的电脑和数据暴露在风险里不值得。5.2 Body发过去后端读空值先查Content-Type这是我见过最多的求助问题明明POST了一个JSON后端一打印全是undefined。排查链路其实很清楚——先看Postman的Headers标签里Content-Type到底是什么再看Body标签里实际选了什么格式。如果Body选的是raw但右侧格式没切到JSON发送出去的Content-Type就是text/plain。后端框架一看不是application/json干脆把请求体当成普通文本你填的键值对它根本解析不出来。解决办法就是Body选raw右侧格式点一下JSON让Postman自动把Content-Type改成application/json。排查时还可以点开底部栏里的Console按钮查看实际发出的原始报文里面能看到真实的Content-Type到底长什么样。这个报文献不会骗人。5.3 本地https自签名报证书错误这样处理在本地做联调时项目可能启动在https://localhost:8443用的是自签名证书。Postman默认会校验证书遇到不在受信列表里的证书直接报类似证书校验失败的错或者干脆显示Could not get response。我第一次遇到时以为是地址写错了反复检查端口和路径后来才反应过来是证书信任问题。处理方式是在Settings里找到SSL certificate verification把它临时关掉。但这里必须划重点这个选项只建议在本地开发环境关闭。生产环境、涉及真实用户数据的接口一定要保持校验开启否则中间人攻击的风险完全暴露在网络上。排查顺序建议是先确认服务真的起来了端口、路径没拼错再考虑是不是自签名证书问题最后看日志确认服务端有没有收到请求。按照这个顺序走大部分请求失败都能在几分钟内找到原因。5.4 集合改动丢失自动保存不是万能保险现在的Postman版本对集合有了自动保存机制改完请求它自己会存基本不需要手动CtrlS。但这不代表你可以随便造。如果你在离线状态下改了集合然后通过任务管理器强行结束进程某些改动可能没写盘就丢了。更麻烦的是离开登录状态时本机改动和云端同步会发生冲突有时候你改的版本会被新版本覆盖。我现在的习惯是两个保险并用。第一保持登录并联网让改动实时进入云端同步。第二给重要集合定期右键Export把JSON文件当作备份存一份到网盘或者代码仓库里。别嫌麻烦等你辛辛苦苦配了五六十个请求后发现一夜回到解放前那才叫崩溃。5.5 中文变成\uXXXX或乱码是转义不是错有段时间我特别疑惑明明响应里中文显示得好好的怎么一复制就变成\u4e2d\u6587这种形式后来才搞明白这是JSON标准允许的Unicode转义很多后端框架在序列化时会默认把中文转成\uXXXX编码发出。它不是乱码也不是数据损坏你在Pretty视图里会正常显示中文复制到别处就还原成转义序列因为这是数据最原始的样子完全不必要在客户端处理。真正要警惕的是中文直接显示成锟斤拷或一堆问号。这种情况大多是因为响应头里的Content-Type没有带charsetutf-8客户端拿UTF-8去解析GBK编码的返回自然会花屏。这种问题爹不疼娘不爱后端加个响应头就能解决你改不了后端的话至少在排错时能定位到是编码声明的锅。我在实际使用中的体会是Postman这类工具最大的价值不只是发请求而是让人把接口当作可积累的资产来管理。先把它装上跑通一个登录接口存进集合用环境变量把地址和token管起来。这一步一旦走通后面再学脚本、断言、自动化Runner都会非常顺。下一篇我准备专门写Pre-request Script和Tests的常用脚本模式把自动登录、参数关联这些玩法一次性展开。如果你在安装或发第一个请求时就卡住了把这几个坑对照查一遍基本都能解决。