Postman在Ubuntu上如何管理集合

在Ubuntu上管理Postman集合的实用指南

一 安装与准备

• 使用 Snap 安装（推荐）：
  • 命令：sudo apt update && sudo apt install snapd
  • 安装：sudo snap install postman
• 手动安装（通用方式）：
  • 下载 Postman-linux-x64-*.tar.gz，解压至 /opt/apps/Postman
  • 创建软链：sudo ln -s /opt/apps/Postman/Postman /usr/local/bin/postman
  • 创建桌面启动器（可选）：编辑 /usr/share/applications/postman.desktop，设置 Name=Postman、Exec=/opt/apps/Postman/Postman、Icon=/opt/apps/Postman/app/resources/app/assets/icon.png 等字段后保存
• 启动与登录：在应用菜单或终端输入 postman 启动，首次使用建议登录 Postman 账户以启用云同步与团队协作

二 创建与组织集合

• 创建集合：在左侧 Collections 面板点击 + 或 New，选择 Blank Collection，填写 名称 与 描述 后 Create
• 添加请求：在集合下点击 Add Request，设置 URL、Method、Headers、Body，点击 Save 保存至集合
• 文件夹与排序：在集合菜单中选择 Add Folder 创建分组；通过 拖拽 调整请求顺序；使用 Duplicate/Delete 复制或删除请求
• 工作区隔离：创建多个 Workspace 分别承载不同项目的集合、环境与请求，便于多项目并行管理

三 导入导出与共享

• 导入集合/环境/数据：
  • 左上角 Import，可从 文件/文件夹/链接/原始文本/代码仓库 导入；也可直接粘贴 cURL 命令自动生成请求
  • 旧版集合 v1 已不再支持，需转换为 v2 后导入（见下文“版本兼容与迁移”）
• 导出集合：在集合右侧 … 选择 Export，推荐选择 Collection v2.1 格式，生成 .json 文件
• 导出环境与全局变量：右上角 Manage Environments → 选择环境或 Globals → Download 导出 .json
• 团队共享与链接：集合 … → Share Collection，可用 Team Sharing 或生成 Collection Link 进行共享

四 运行与自动化测试

• 批量运行：在集合或文件夹上点击 Run 打开 Collection Runner，可配置 迭代次数、间隔 等参数后执行
• 编写测试：在请求的 Tests 选项卡使用 JavaScript 编写断言，例如：
  • 状态码：pm.test(“Status code is 200”, () => pm.response.to.have.status(200));
  • 响应时间：pm.test(“Response time < 200ms”, () => pm.expect(pm.response.responseTime).to.be.below(200));
• 环境变量：右上角 Manage Environments 创建环境，在请求中使用 {{variable_name}} 引用变量，便于多环境切换

五 版本兼容与迁移及CI集成

• 版本兼容与迁移：
  • 集合 v1 无法导入，使用 Postman Collection Transformer 转换：sudo npm install -g postman-collection-transformer
  • 转换命令示例：postman-collection-transformer convert -i input.json -o output.json -j 1.0.0 -p 2.0.0 -P
• 数据转储与备份：
  • 顶部 Settings → Data → Export Data 发起导出请求，完成后通过页面或邮件 下载压缩包（适合完整备份）
• CI/CD 自动化：
  • 使用 Newman（Postman CLI）：npm install -g newman
  • 运行示例：newman run collection.json -e environment.json
  • 可集成到 Jenkins/GitHub Actions/GitLab CI 等流水线，实现持续集成测试