postman接口文档需按场景选择导出方式：①导出html用于离线交付；②发布在线文档实现团队实时共享；③导出openapi 3.0对接swagger/apifox；④分享集合+环境json文件供同事本地复用。
要把Postman里调试好的接口快速整理成可读、可传、可复用的文档，直接导出集合本身远远不够——它只是JSON数据包，不带格式、不带说明、不能在线查看，同事拿到后还得手动点开每个请求去理解。必须走对路径，才能让接口真正“说人话”。
导出静态HTML文档（离线交付首选）
这一步适合发给测试、产品或外部合作方，他们没装Postman也能打开看清楚每个接口的URL、参数、响应示例和描述。
点击左侧目标集合右侧的⋯按钮→选择Export→在弹出菜单中选Export as HTML。
指定保存路径，文件名建议包含项目名和日期，比如api-doc-v2-20260529.html，点击保存即可生成单页HTML文件。
双击打开，浏览器里就能看到带目录、带折叠请求块、带响应预览的完整文档。注意：如果集合里某个请求没写Description，对应位置会显示“no description”，建议导出前统一补全。
发布在线交互式文档（团队实时共享）
这是Postman原生最省心的文档方案，生成后自动托管在Postman服务器，链接一发，所有人看到的都是最新版，改完集合点下同步就更新。
第一步：右键点击集合→选择Publish Docs。
第二步：在网页弹窗中确认集合版本，设置可见性为Workspace-only（推荐，仅限当前工作区成员访问）。
第三步：点击Publish，等待几秒，页面顶部出现绿色提示条并显示唯一URL。
第四步：复制该URL，发到团队群或嵌入Confluence。任何人点击即可查看带“Run in Postman”按钮的交互式页面——点一下就能在自己Postman里自动加载并发送该请求。
Postman Mac版是一款专为macOS设计的API开发与测试工具，凭借简洁的界面和强大的功能，深受开发者喜爱。它支持发送各种HTTP请求（GET、POST、PUT等），轻松管理接口集合、环境变量和模拟服务器。Mac用户可享受原生性能、快捷键优化及与系统无缝集成的体验，适用于接口调试、自动化测试和文档生成。无论是个人项目还是团队协作，Postman for Mac都能提升API开发效率，是ma
【发布前务必清空历史记录】否则旧请求可能残留，导致同事看到的文档和你本地不一致。
导出OpenAPI 3.0文件（对接Swagger/Apifox等平台）
如果你的公司已用Swagger UI做统一文档门户，或正在迁移到Apifox、YApi这类平台，就必须导出标准OpenAPI格式。
方法一：集合右侧⋯→Export→Export OpenAPI 3.0→勾选Include response examples→点击Export。
方法二：若需YAML格式，勾选Export as YAML再导出，文件后缀自动变为.yaml。
导出的openapi.json可直接拖进Swagger Editor，瞬间渲染成带UI的文档；也可上传至Apifox，自动解析并生成测试用例。
注意：Postman不会导出环境变量中的值，敏感字段如Authorization头若写死在请求里，会一并进入OpenAPI文件——导出前请检查并替换为变量引用。
分享集合文件给同事（最基础但最常用）
这是新人上手最快的方式，适合内网、无账号、或临时交接场景，但要注意配套动作，否则同事导入后可能无法运行。
选中集合→点击右侧⋯→Export→选择Collection v2.1 (recommended)→保存为xxx-collection.json。
如果集合依赖环境变量（比如base_url、token），必须额外导出环境：右上角齿轮图标→进入Environments→选中对应环境→点击右侧下载图标→保存为xxx-env.json。
把这两个文件一起发给同事，对方在Postman中依次点击Import → Upload Files，同时选中两个JSON文件，系统会自动关联集合与环境。
