必须手动点击集合右侧“…”选择“Share Collection”才能生成分享链接,登录账户是前提,未登录时需先跳转登录;链接默认永久有效但仅展示文档,不包含环境变量或执行能力。

点击“…”后选“Share Collection”才能生成链接
Postman 不会在创建集合后自动提供分享链接,必须手动触发共享流程。常见误区是点错位置——比如误点集合名旁的“▶”展开箭头,或在请求层级点“…”(此时弹出的是单个请求操作菜单,没有 Share 选项)。正确路径是:在左侧 Collections 列表中,鼠标悬停或点击集合右侧的 … 按钮,从下拉菜单中明确选择 Share Collection。
进入分享面板后,默认处于 Link Sharing 标签页,此时只要确保开关已开启(Toggle 为蓝色),下方就会显示可复制的链接。如果开关灰色不可点,说明尚未登录 Postman 账户——Ubuntu/Linux 桌面版也必须登录才能启用链接生成。
- 未登录时点击
Share Collection会跳转登录页,登完需手动返回重试 - 链接默认有效期为永久,但若集合被删除或权限关闭,链接立即失效
- 该链接仅展示文档(请求 URL、方法、参数、示例),不包含环境变量值或测试脚本执行能力
“Run in Postman”按钮需要额外生成且依赖客户端
普通分享链接只能看不能调,想让对方一键发送请求,必须启用 Run in Postman 功能。它不在主分享面板里,而是在同一 Share Collection 窗口中切换到 Run in Postman 标签页,勾选 Enable Run in Postman button 后,页面底部才会出现可嵌入或复制的按钮代码。
这个按钮本质是 HTML + JavaScript 片段,粘贴到网页中即可渲染成按钮;点击后会尝试唤起本地 Postman 应用(Windows/macOS/Linux 均支持),并导入集合。但有硬性前提:
- 对方设备上必须已安装 Postman 桌面版(浏览器版不支持导入)
- 若对方已有同名集合,Postman 会提示“覆盖”或“另存为”,不会静默失败
- 按钮不传递环境变量——即使你当前用了
{{base_url}},导入后该变量仍为空,需对方手动配置或附带环境文件
导出 JSON 文件比链接更可控,尤其适合离线协作
当对方没装 Postman、网络受限、或你需要精确控制版本(比如只分享 v1.2 集合,不希望对方看到后续修改),Export 是更稳妥的选择。右键集合 → Export → 选 Collection v2.1(推荐,兼容性最好)→ 保存为 .json 文件。
注意几个易错点:
- 不要选
v2(旧版),它不支持部分新字段如event脚本中的某些钩子 - 导出时勾选
Include environment variables是无效的——环境变量必须单独导出,集合 JSON 里只存引用名(如{{api_key}}),不存真实值 - 对方导入时:Postman 左上角
Import→ 选该 JSON 文件 → 点击Import,集合即出现在左侧列表
团队共享要进“Team Sharing”标签页,且权限不可绕过
如果你在 Postman Pro 或 Enterprise 团队中,直接用链接分享可能让成员看不到最新变更——因为链接默认指向发布快照,而非实时同步。真正实现实时协同,必须进 Share Collection 面板的 Team Sharing 标签页,手动添加团队并设权限。
这里的关键限制是:
- 免费账户无法使用
Team Sharing,界面该标签页直接不显示 - 即使你是管理员,给成员设了
Can edit权限,他们也无法修改集合描述或文档样式——这些仍需 Owner 操作 - 团队共享后,集合右上角会出现
Shared with team徽标,但链接分享仍独立存在,两者互不影响
最常被忽略的一点:环境变量必须单独共享。哪怕集合已团队共享,Environment 仍需单独打开、点 … → Share → Share with Team,否则成员导入集合后,所有 {{xxx}} 都会报错未定义。


















