Debian 上 Postman 导入导出设置指南
一 适用范围与准备
- 适用于在 Debian 上安装的 Postman（桌面版/应用菜单均可）。以下操作路径与按钮名称与桌面版一致。
- 建议先关闭 Postman 再进行批量导入导出，避免文件占用或写入冲突。
二 导出设置与数据
- 导出集合 Collection
- 在左侧 Collections 中选中目标集合，点击右侧 … → Export。
- 选择格式 Collection v2.1 (recommended)，保存到本地（文件后缀为 .json）。
- 导出环境与全局变量
- 进入 Environments，选择目标 Environment → 右上角 … → Export；或在 Globals 面板右上角 Export。
- 导出为 JSON 文件，便于迁移与备份。
- 导出完整数据转储 Postman Dump
- 点击右上角 Settings → Data → Export Data，可一次性导出工作区中的 集合、环境、全局变量 等到一个打包文件，适合迁移整站配置。
三 导入设置与数据
- 常规导入入口
- 左上角 Import，支持从 文件、文件夹、链接、粘贴原始文本、代码仓库 导入；也可直接拖拽文件/文件夹到导入窗口。
- 常见导入类型
- 文件/文件夹：导入 集合 JSON、环境 JSON、全局变量 JSON 等。
- 链接：导入公开分享的集合链接（需登录 Postman 账号）。
- 粘贴原始文本：可粘贴 cURL、OpenAPI/Swagger、HAR 等，自动生成请求或集合。
- 代码仓库：从 GitHub/Bitbucket/GitLab 导入 API 定义或集合（远程导入需登录）。
- 导入时的冲突处理
- 同名集合：可选择 Replace（覆盖） 或 Import as Copy（作为副本导入）。
- 同名全局变量：导入仅覆盖 初始值（Initial Value），当前值（Current Value） 保持不变。
- 同名环境：允许并存，不受影响。
四 常见问题与进阶
- 集合 v1 格式不再支持
- 若导入报错，可用 Postman Collection Transformer 将 v1 → v2：
- 安装：sudo npm install -g postman-collection-transformer
- 转换：postman-collection-transformer convert -i <输入文件> -o <输出文件> -j 1.0.0 -p 2.0.0 -P
- 批量迁移更省事
- 使用 Settings → Data → Export Data 导出完整数据，在目标机器 Import 同一文件即可恢复集合、环境与全局变量。
- 导入 cURL 的快捷方式
- 在 Import 中粘贴 cURL 命令，或在请求 URL 输入框直接粘贴，Postman 会自动创建请求。