如何导入和导出 Postman Collections (2026)

如何导入和导出 Postman 集合 (2026版)

Postman 集合（Collections）是组织、共享和记录 API 请求的标准方式。无论你是与团队共享端点、在工作区之间迁移、备份工作，还是设置 CI/CD 流水线，掌握如何高效地导入和导出集合都至关重要。

本指南涵盖了 2026 年导入和导出 Postman 集合的每种方法，包括桌面应用程序、Postman API、CLI 以及常用格式。

什么是 Postman 集合？

Postman 集合是一个 JSON 文件，其中包含一组 API 请求及其配置：

• 请求 URL、方法、请求头（Headers）和正文（Bodies）
• 前置脚本（Pre-request scripts）和测试脚本（Test scripts）
• 变量和身份验证设置
• 文件夹结构和文档
• 示例响应

集合使用 .json 格式，并遵循 Postman 的 Collection v2.1 架构。

导出集合

方法 1：从 Postman 桌面应用导出

导出集合最简单的方法：

1. 打开 Postman，在左侧边栏导航至 Collections
2. 点击集合名称旁边的三个点 (...)
3. 选择 Export
4. 选择格式：
   • Collection v2.1 (Recommended) —— 当前标准格式
   • Collection v2.0 —— 旧格式，兼容性更广
5. 点击 Export 并选择 .json 文件的保存位置

方法 2：通过 Postman API 导出

使用 Postman API 以编程方式导出集合：

# 从以下地址获取你的 Postman API key: https://web.postman.co/settings/me/api-keys

# 列出所有集合
curl -s -X GET "https://api.getpostman.com/collections" \
  -H "X-Api-Key: YOUR_POSTMAN_API_KEY" | jq '.collections[] | {name, uid}'

# 通过 UID 导出特定集合
curl -s -X GET "https://api.getpostman.com/collections/YOUR_COLLECTION_UID" \
  -H "X-Api-Key: YOUR_POSTMAN_API_KEY" \
  -o my-collection.json

# 用于导出所有集合的 Python 脚本
import requests
import json
import os

API_KEY = "YOUR_POSTMAN_API_KEY"
HEADERS = {"X-Api-Key": API_KEY}
BASE_URL = "https://api.getpostman.com"

# 获取所有集合
response = requests.get(f"{BASE_URL}/collections", headers=HEADERS)
collections = response.json()["collections"]

# 导出每个集合
os.makedirs("postman_backup", exist_ok=True)
for col in collections:
    uid = col["uid"]
    name = col["name"].replace(" ", "_").replace("/", "_")

    detail = requests.get(f"{BASE_URL}/collections/{uid}", headers=HEADERS)

    with open(f"postman_backup/{name}.json", "w") as f:
        json.dump(detail.json(), f, indent=2)

    print(f"Exported: {name}")

方法 3：通过 Postman CLI (Newman) 导出

Newman 是 Postman 的命令行工具。虽然它主要用于运行集合，但你可以将其与 API 结合用于导出工作流：

# 安装 Newman
npm install -g newman

# 一步完成集合的导出和运行
curl -s "https://api.getpostman.com/collections/YOUR_COLLECTION_UID" \
  -H "X-Api-Key: YOUR_POSTMAN_API_KEY" \
  -o collection.json

# 运行导出的集合
newman run collection.json --environment env.json

方法 4：通过公共链接共享

无需文件导出即可快速共享：

1. 点击集合旁边的三个点
2. 选择 Share
3. 选择 Get public link
4. 复制链接并分享

任何拥有该链接的人都可以查看并导入该集合。

导入集合

方法 1：导入 JSON 文件

最常用的导入方法：

1. 打开 Postman
2. 点击左上角的 Import（或按下 Ctrl/Cmd + O）
3. 选择以下操作之一：
   • 拖放 你的 .json 文件
   • Upload files —— 浏览并选择文件
   • Paste raw text —— 直接粘贴 JSON 内容
4. Postman 将显示待导入内容的预览
5. 点击 Import 确认

方法 2：从 URL 导入

直接从 URL 导入集合：

1. 在 Postman 中点击 Import
2. 选择 Link 选项卡
3. 粘贴指向集合 JSON 文件的 URL（例如来自 GitHub、Gist 或 Postman 公开链接）
4. 点击 Continue，然后点击 Import

# 可用的示例 URL：
https://raw.githubusercontent.com/user/repo/main/collection.json
https://api.getpostman.com/collections/UID?apikey=KEY
https://www.getpostman.com/collections/SHARE_ID

方法 3：从 cURL 导入

你可以从 cURL 命令导入单个请求：

1. 点击 Import
2. 选择 Raw text
3. 粘贴你的 cURL 命令：

curl -X POST "https://api.example.com/users" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer token123" \
  -d '{"name": "John", "email": "john@example.com"}'

4. Postman 会自动将其转换为请求

方法 4：从 OpenAPI/Swagger 导入

从 OpenAPI 规范导入整个 API：

1. 点击 Import
2. 上传你的 openapi.yaml 或 swagger.json 文件
3. Postman 会生成一个包含所有端点的完整集合

# 或从 URL 导入
# 在 Import > Link 选项卡中粘贴此 URL：
https://petstore.swagger.io/v2/swagger.json

Postman 支持：

• OpenAPI 3.0 和 3.1 (YAML 和 JSON)
• Swagger 2.0
• GraphQL schemas
• RAML
• WSDL

方法 5：通过 Postman API 导入

# 通过 API 导入集合
curl -X POST "https://api.getpostman.com/collections" \
  -H "X-Api-Key: YOUR_POSTMAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d @my-collection.json

# Python: 导入集合
import requests
import json

API_KEY = "YOUR_POSTMAN_API_KEY"

with open("my-collection.json") as f:
    collection_data = json.load(f)

response = requests.post(
    "https://api.getpostman.com/collections",
    headers={
        "X-Api-Key": API_KEY,
        "Content-Type": "application/json"
    },
    json=collection_data
)

print(response.json())

导出和导入环境 (Environments)

集合通常依赖于环境变量。请记得也要导出它们。

导出环境

1. 在左侧边栏点击 Environments
2. 点击环境名称旁边的三个点
3. 选择 Export
4. 保存 .json 文件

导入环境

1. 点击 Import
2. 上传环境 JSON 文件
3. Postman 会将其添加到你的 Environments 中

环境文件格式

{
  "name": "Production",
  "values": [
    {
      "key": "base_url",
      "value": "https://api.example.com",
      "type": "default",
      "enabled": true
    },
    {
      "key": "api_key",
      "value": "sk-your-key-here",
      "type": "secret",
      "enabled": true
    }
  ]
}

警告： 导出的环境文件包含纯文本格式的机密值。在分享前请删除敏感值。

支持的导入/导出格式

格式	导入	导出	备注
Postman Collection v2.1	是	是	推荐格式
Postman Collection v2.0	是	是	旧版格式
OpenAPI 3.0/3.1	是	是	行业标准
Swagger 2.0	是	否	过时格式
cURL	是	是 (按请求)	仅限单个请求
HAR	是	否	HTTP 归档格式
GraphQL	是	否	Schema 导入
RAML	是	否	RESTful API 建模
WSDL	是	否	SOAP APIs

最佳实践

对集合进行版本控制

将集合与代码一起存储在 Git 中：

# 项目结构
my-api/
├── src/
├── tests/
├── postman/
│   ├── collection.json
│   ├── environment.dev.json
│   ├── environment.staging.json
│   └── environment.prod.json
├── package.json
└── README.md

自动化集合备份

#!/bin/bash
# backup-postman.sh - 通过 cron 每周运行

API_KEY="YOUR_POSTMAN_API_KEY"
BACKUP_DIR="./postman-backups/$(date +%Y-%m-%d)"
mkdir -p "$BACKUP_DIR"

# 获取所有集合的 UID
COLLECTIONS=$(curl -s "https://api.getpostman.com/collections" \
  -H "X-Api-Key: $API_KEY" | jq -r '.collections[] | .uid')

for UID in $COLLECTIONS; do
  NAME=$(curl -s "https://api.getpostman.com/collections/$UID" \
    -H "X-Api-Key: $API_KEY" | jq -r '.collection.info.name' | tr ' /' '__')

  curl -s "https://api.getpostman.com/collections/$UID" \
    -H "X-Api-Key: $API_KEY" \
    -o "$BACKUP_DIR/${NAME}.json"

  echo "Backed up: $NAME"
done

分享前移除机密信息

# strip-secrets.py - 在分享前移除敏感值
import json
import sys

with open(sys.argv[1]) as f:
    env = json.load(f)

for val in env.get("values", []):
    if val.get("type") == "secret":
        val["value"] = "REPLACE_ME"

with open(sys.argv[1].replace(".json", "-clean.json"), "w") as f:
    json.dump(env, f, indent=2)

故障排除

问题	解决方案
导入失败并提示 "invalid format"	检查 JSON 是否合法；使用 JSON 校验器
变量显示为 {{undefined}}	将环境文件随集合一起导入
Collection v2.0 与 v2.1 不匹配	使用 v2.1 格式重新导出
大型集合导入缓慢	按功能拆分为较小的集合
分享链接已过期	从集合中重新生成一个新的公共链接
导入后脚本未运行	检查脚本依赖项是否已记录在文档中

常见问题

我可以将 Postman 集合导入到其他工具中吗？ 可以。像 Insomnia、Thunder Client (VS Code) 和 Bruno 等工具都支持 Postman 集合格式。OpenAPI 导出几乎适用于任何 API 工具。

集合导出有大小限制吗？ Postman 没有强制规定严格的大小限制，但非常大的集合（100MB+）导入可能会很慢。建议考虑对其进行拆分。

我可以合并两个集合吗？ 没有内置的合并功能。你可以将两者都导出为 JSON，手动或通过脚本合并，然后重新导入。

导出的集合包含测试结果吗？ 不包含。导出内容包含测试脚本，但不包含历史测试结果。请使用 Newman 进行 CI/CD 测试运行。

总结

一旦了解了可用方法，导出和导入 Postman 集合就会变得非常简单。对于团队协作，使用 Postman API 进行自动化；对于版本控制，将其导出为 JSON 并提交到 Git；对于跨工具兼容性，请使用 OpenAPI 格式。

如果你正在测试用于图像生成、视频创建或头像合成的 AI 驱动 API，免费试用 Hypereal AI —— 包含 35 个额度，无需信用卡。该 API 附带了随时可用的 Postman 集合，方便你进行测试。