导出接口集合必须选Collection v2.1格式、确保请求已保存至集合且右侧有锁图标、清空History再导出，否则会丢失脚本、变量或旧URL；文件名建议含项目标识和日期。
导出接口集合必须选中 Collection v2.1 (recommended)，否则同事导入后可能丢失测试脚本、Pre-request Scripts 或变量引用——这不是兼容性问题，而是旧版本格式根本没定义这些字段。
导出前必须确认请求已真实保存进集合
Postman 的“未保存请求”不会出现在导出文件里，哪怕它显示在集合列表中。常见现象是：右键集合 → Export → 导出的 JSON 里 item 数量比你看到的少；打开 JSON 文件搜 "name"，发现缺了刚写的那个接口。
- 每个请求右侧必须有小锁图标，不能带
unsaved request字样 - 新建请求后务必按
Ctrl+S（或点击右上角Save），并在弹窗的Save to下拉菜单里手动选中目标集合 - 如果误点了
Save as new request却没选集合，该请求只存在 History 里，导出时自动被跳过
导出操作本身只有两步，但路径和格式不能错
鼠标悬停在集合名右侧的 ⋯ 按钮上 → 点击 Export → 弹窗中唯一要勾选的是 Collection v2.1 (recommended) → 点击 Export → 保存为 .json 文件。
Postman Mac版是一款专为macOS设计的API开发与测试工具，凭借简洁的界面和强大的功能，深受开发者喜爱。它支持发送各种HTTP请求（GET、POST、PUT等），轻松管理接口集合、环境变量和模拟服务器。Mac用户可享受原生性能、快捷键优化及与系统无缝集成的体验，适用于接口调试、自动化测试和文档生成。无论是个人项目还是团队协作，Postman for Mac都能提升API开发效率，是ma
- 不要选
Collection v2.0：不支持event类型的脚本（比如 Tests 和 Pre-request Scripts） - 不要选
Collection v1：Postman 已弃用，新版本导入会报错Invalid collection format - 文件名建议含项目标识和日期，例如
payment-api-collection-20261104.json，避免覆盖
为什么清空 History 是硬性前置步骤
Postman 的导出逻辑依赖本地索引状态，而 History 缓存可能污染这个索引。典型表现是：你刚改完一个请求的 URL 并保存进集合，导出后打开 JSON 文件，里面还是旧 URL；同事导入后运行，报错 404。
- 必须先切到
History标签页 → 点右上角⋯→Clear all history - 再切回
Collections标签页，刷新左侧列表，确认所有请求都可点开、内容最新 - 这步不是“清理垃圾”，而是强制 Postman 重建当前工作区的内存快照，导出才可靠
最易被忽略的点：导出动作本身不校验集合内请求是否语法合法。比如某个请求的 Tests 脚本里写了 pm.test("status", () => { assert.equal(…)}); 却没引入 assert，导出 JSON 不报错，但同事导入后一运行就卡在脚本加载阶段——得逐个点开请求的 Tests 面板才能发现。
