必须先把请求保存到Collection中,否则“Save as example”按钮灰色不可点,因为该功能强依赖Collection结构;请求未归属Collection时处于临时标签页状态,无法生成示例快照。

必须先把请求保存到 Collection 中,否则“Save as example”按钮是灰色不可点的。
为什么点不了“Save as example”
Postman 的示例(Example)功能强依赖 Collection 结构。即使你已经发出了请求、看到了完整响应,只要该请求没被显式保存进某个 Collection,右上角的 Save Response 下拉菜单里就不会出现 Save as example 选项。
- 常见错误现象:
Save Response按钮存在,但点击后只有Save as file,没有Save as example - 根本原因:请求处于“临时标签页”状态,未归属任何 Collection
- 解决动作:先点
Save(右上角 Send 按钮旁),填名称、选 Collection、确认保存;再发一次请求,响应区才会出现完整的保存选项 - 额外注意:WebSocket 请求不支持示例;gRPC 流式响应(streaming)必须等流结束才能点
Save as example
保存示例时 body 和 headers 都会保留吗
会,但有隐含限制:Postman 保存的是「当前响应快照」,包括状态码、所有响应头(Headers)、Cookies、以及响应体(Body)的原始字节内容 —— 但不会记录发送时的请求头或请求体。
Postman 12.27.7 Windows x64 官方安装包,适用于 API 设计、调试、测试与协作。该系列包含 Enterprise 云端性能测试静态 IP 出口能力,以及接口规范标签管理改进,适合受限网络测试与规范资源组织场景。
- 实际效果:你后续在 Collection 里点开这个示例,看到的是和当时一模一样的
Status: 200 OK、Content-Type: application/json、Set-Cookie等,以及格式化后的 JSON 或 HTML 内容 - 容易踩的坑:如果你用的是
Pretty视图查看响应,保存的仍是原始 body;但若响应是压缩过的(如Content-Encoding: gzip),Postman 会自动解压后再保存,所以示例里显示的是解压后的内容 - 参数差异:示例不包含动态值(比如时间戳、token 过期时间),它就是静态快照 —— 所以不能替代 mock server 的动态逻辑
示例保存后在哪看、怎么复用
保存成功后,示例会挂在对应请求节点下方,展开请求即可看到带名称的示例条目;调用时直接从右上角 Examples 下拉菜单选择即可。
- 查看路径:Collection → 请求名 → 向下箭头展开 → 出现
Examples区域 → 点击示例名称 - 编辑方式:点击示例右侧的铅笔图标,可修改名称、状态码、headers、body(支持
raw/json/html等格式切换) - 复用场景:写文档时插入响应样例、给前端提供固定返回结构、配合 Postman Mock Server 生成模拟接口
- 性能影响:示例本身不消耗运行资源,但 Collection 节点过多且每个请求存了多个示例时,左侧导航栏加载略慢(无实质影响)
最常被忽略的一点:示例里的响应头是只读快照,哪怕你手动编辑了 Content-Length,Postman 也不会校验或同步更新;它只是展示用 —— 如果你靠改 header 来调试兼容性问题,得回到真实请求里去调。

















