如何在Ubuntu上使用Postman管理API集合

在Ubuntu上使用Postman管理API集合

一 安装与启动

• 使用 Snap（推荐）
  • 更新并安装：sudo apt update && sudo apt install snapd
  • 安装 Postman：sudo snap install postman --classic
• 使用官方压缩包
  • 下载：wget https://dl.pstmn.io/download/latest/linux64 -O postman.tar.gz
  • 解压到 /opt：sudo tar -xzf postman.tar.gz -C /opt
  • 创建软链：sudo ln -s /opt/Postman/Postman /usr/local/bin/postman
  • 启动：在应用菜单打开 Postman 或执行 postman
• 以上两种方式均为 Ubuntu 上常用的安装路径，Snap 更省事，压缩包便于自定义位置与集成。

二 创建与组织集合

• 新建集合：左侧 Collections → 右上角 + → Blank Collection → 填写 Name/Description → Create
• 添加请求：进入集合 → Add Request → 选择 GET/POST/PUT/DELETE → 填写 URL/Headers/Body → Save
• 文件夹分组：集合菜单 … → Add Folder → 将相关请求拖入，便于模块化管理
• 变量与认证：通过 Manage Environments 创建环境（如 dev/staging/prod），在请求中以 {{variable}} 引用；在 Headers 中使用 Bearer {{token}} 等完成鉴权。

三 运行与自动化测试

• 批量运行：集合或文件夹右侧 Run → 配置 迭代次数/延迟 → Start Run，查看每个请求的 Tests 结果
• 常用断言示例（Tests 标签页）
  • 验证状态码：pm.test(“状态码为200”, () => pm.response.to.have.status(200));
  • 验证字段值：pm.test(“用户名正确”, () => { const json = pm.response.json(); pm.expect(json.name).to.eql(“test_user”); });
• 预请求脚本：在 Pre-request Script 中设置变量、时间戳、签名等，保证请求前置条件一致。

四 共享与团队协作

• 团队共享：集合 … → Share Collection → Team Sharing（需登录 Postman 账号并加入团队工作区）
• 链接分享：选择 Collection Link 生成可访问链接，便于外部协作者查看或 Fork
• 版本管理：Postman 不内置 Git 版本控制，建议将集合 导出为 JSON 纳入 Git 仓库，配合注释与 PR 流程管理变更历史。

五 CI/CD集成与命令行运行

• 安装 Newman：npm install -g newman
• 基本运行：导出集合为 collection.json，执行 newman run collection.json
• 常用增强：指定环境变量 newman run collection.json -e dev.env.json；生成报告 newman run collection.json -r cli,html,json
• 在 Jenkins/GitLab CI/GitHub Actions 中把 Newman 命令加入流水线，实现接口回归自动化与质量门禁。