Ubuntu 上 Postman 团队协作实操指南
一 环境准备与安装
- 在 Ubuntu 上安装 Postman（任选其一）：
- 使用 Snap（推荐）：sudo snap install postman --classic
- 使用 APT（备用）：
- wget https://dl.bintray.com/postman/apt/postman-apt.gpg -O /usr/share/keyrings/postman-archive-keyring.gpg
- echo “deb [signed-by=/usr/share/keyrings/postman-archive-keyring.gpg] https://dl.bintray.com/postman/apt stable jdk11” | sudo tee /etc/apt/sources.list.d/postman.list > /dev/null
- sudo apt-get update && sudo apt-get install postman
- 启动 Postman 并使用 Postman 账号登录，以便启用基于云端的团队协作能力（如团队、工作区、同步）。
二 创建团队与邀请成员
- 创建团队：在 Postman 中进入个人资料或团队入口，选择 Teams → Create Team，填写团队名称与描述，选择团队类型（公开/私有）。
- 邀请成员：进入团队管理页面，点击 Invite Member，输入成员邮箱发送邀请；成员接受后即可加入团队。
- 创建团队工作区：左侧 Workspaces → Create Workspace，输入名称与描述，类型选择 Team，并将相关成员加入该工作区，用于集中承载集合、环境与文档。
三 共享与权限管理
- 共享集合：打开目标集合，点击 Share → Share with Team，选择目标团队并设置权限（如只读/可编辑），实现集合的团队内共享与实时协作。
- 共享环境：在环境面板中选择目标环境，点击 Share 并选择团队或生成链接，以便统一维护 开发/测试/预发/生产 等环境的变量（如 base_url、token）。
- 权限与可见性：在团队或工作区层面为成员分配角色与权限，控制谁可以查看、编辑、管理环境与文档，确保敏感信息可控与最小权限原则。
四 协作与版本控制实践
- 实时协作：将集合与环境放入 团队工作区，成员可在各自客户端实时看到变更，减少手工同步成本。
- 导出/导入（离线或与非 Postman 用户协作）：在集合或请求上右键 Export 导出为 Collection v2.1 JSON；对方通过 Import 导入。适合评审、归档或跨组织传递，但无实时同步。
- 生成链接与嵌入：集合 Share → Generate Link 生成公开/私有链接，或生成 嵌入代码 放入公司 Wiki/文档，便于查看与 “Run in Postman”。
- 版本控制与 CI：
- 内置版本历史：集合/环境支持查看 版本历史、对比差异与回滚，便于追踪变更与快速恢复。
- 与 GitHub 集成：在集合上启用 版本控制，连接 GitHub 仓库，选择分支进行 推送/拉取/合并 与冲突解决，形成 API 变更的审计链路与代码审查流程。
- 在 Jenkins 等 CI 中执行 Postman 集合（Newman），实现自动化回归测试与质量门禁。
五 安全与排错要点
- 敏感信息管理：切勿在请求中硬编码 API Key/密码；统一放入 环境/全局变量，并按环境隔离，必要时使用 Secrets 管理 或 CI 的受控变量注入。
- 链接与访问控制：对外共享链接务必设置为 私有 并限制 可编辑 权限；仅对需要协作的对象生成链接，减少暴露面。
- 导入完整性：导出/导入时确保包含 预请求脚本、测试脚本、示例 等，避免协作时丢失关键逻辑。
- 常见问题排查：
- 成员看不到更新：确认已加入同一 团队工作区，且集合/环境已 共享 给该成员或其所属角色。
- 权限异常：在团队/工作区/资源三级检查 角色与权限 配置，确保具备相应的查看或编辑权限。
- 版本冲突：多人同时编辑同一集合时，使用 版本历史 回滚或 GitHub 分支合并 解决冲突，再同步到团队工作区。
