Postman团队协作必须基于Team工作区:先创建团队工作空间,将集合移入其中并点击Share→Share with your team;成员需用同一邮箱注册并接受邀请,确保Postman版本一致且同步状态为Synchronized,Linux用户须检查~/.config/Postman权限。

Postman 本身不支持直接“邀请同事维护单个集合”,所有协作必须基于团队(Team)空间,且集合共享权限由团队角色或显式设置控制。试图绕过团队、用导出 JSON 文件方式“协作”,实际会导致脚本丢失、环境变量不同步、历史变更不可追溯。
怎么创建并加入 Postman 团队
这是协作的前提,没有团队,集合只能本地保存或手动导出导入(等于没协作):
- 登录 Postman 后,点击右上角头像旁的
Workspaces>Create a new workspace> 选择Team - 填写团队名称(如
backend-api-team),完成后系统自动生成团队同步空间 - 新成员必须用同一邮箱注册 Postman 账号,且接受邀请链接(不是仅登录即可)
- Linux 桌面(CentOS/Ubuntu)用户需确认已安装官方 Postman Linux 版(非 Snap 或 Flatpak 封装版),否则同步功能异常
怎么把已有集合共享给团队成员
集合必须先保存在 Team 工作区下,才能被他人看到和编辑:
Postman 12.27.7 Windows x64 官方安装包,适用于 API 设计、调试、测试与协作。该系列包含 Enterprise 云端性能测试静态 IP 出口能力,以及接口规范标签管理改进,适合受限网络测试与规范资源组织场景。
- 打开目标集合,点击右上角
⋯>Share,勾选Share with your team - 若集合当前在
Personal工作区,Share按钮是灰色的——必须先拖拽或通过Move to workspace将其移入 Team 工作区 - 共享后,其他成员在自己 Postman 的
Workspaces切换到该 Team,就能看到同名集合;默认拥有编辑权限(除非管理员降权) - 不要点
Export再发 JSON 给同事——这会丢掉pre-request script、Tests、请求间变量引用等关键逻辑
为什么同事改了集合,我本地看不到更新
这不是网络问题,而是同步机制未触发或配置错误:
- 确保双方都使用相同 Postman 版本(
Settings>About查看,2026 年主流版本为v12.1.x,旧版如 v9 不再同步集合元数据) - 检查左下角状态栏是否显示
Synchronized;若显示Sync paused,点开后手动点击Resume sync - Linux 用户常见坑:
~/.config/Postman目录权限被误设为 root,导致同步服务无法写入缓存,需运行chown -R $USER:$USER ~/.config/Postman - 集合内新增的文件夹或请求,有时需手动刷新工作区(Ctrl+R / Cmd+R),而非等待自动轮询
真正卡住协作的,往往不是“怎么点分享”,而是团队工作区没建对、集合没挪进去、或者 Linux 权限锁死了同步进程。这些地方一错,后续所有测试脚本、环境变量联动、Mock 文档生成都会断链。

















