Postman仅支持导入标准Collection v2.1+（含"info"和"item"字段）和Environment（扁平键值对）JSON格式；OpenAPI/Swagger需先用openapi-to-postman转换，环境变量须为顶层字符串/数字/布尔/null，导入前建议用jsonlint校验语法。
Postman 能直接导入符合 Collection v2.1+ 或 Environment 格式的 JSON 文件，但不能直接解析任意结构的接口文档（比如 OpenAPI 3.0 原生 JSON、Swagger 2.0 JSON、自定义字段的配置 JSON）。导入失败，八成是格式不匹配，不是操作问题。
Postman 只认两种标准 JSON 结构
它内部只识别两类导出/导入协议：Collection（含请求列表）和 Environment（键值对变量）。这两类 JSON 必须带特定顶层字段，否则会报 invalid collection format 或 unexpected token：
-
Collection必须有"info"和"item"字段，且"item"是数组；示例开头必须是{ "info": { "name": ... }, "item": [ ... ] } -
Environment必须是扁平对象，顶层不能嵌套，且每个值只能是字符串、数字、布尔或 null；错误写法如{"dev": {"host": "api.dev"}}会静默忽略dev字段 - 如果你手写的 JSON 没走 Postman 导出流程（比如从 Swagger 转换后没调用
openapi-to-postman工具），大概率无法直入
导入时选错入口，JSON 就会被当数据文件用
很多人把用于 Runner 的 xxx.json 数据文件（格式为 [{"a":1},{"a":2}]）和 Collection JSON 混为一谈。这两者用途完全不同：
Postman 12.27.7 Windows x64 官方安装包，适用于 API 设计、调试、测试与协作。该系列包含 Enterprise 云端性能测试静态 IP 出口能力，以及接口规范标签管理改进，适合受限网络测试与规范资源组织场景。
- Collection JSON：通过左上角
Import→File导入，进侧边栏变成可展开的请求集合 - Runner 数据 JSON：必须在
Runner界面点Select File，且内容必须是数组，单个对象会报data must be an array - 如果误把数据 JSON 拖进
Import → File，Postman 会尝试按 Collection 解析，结果通常是空集合或报错
Swagger/OpenAPI JSON 怎么导入？不能直接拖
原生 api-docs.json（OpenAPI 3.0）或 swagger.json（Swagger 2.0）不是 Postman 原生支持格式。直接拖进去会提示 Unsupported file type 或解析出空集合：
- 正确做法是用
Import → Link，粘贴 OpenAPI URL（如https://example.com/v3/api-docs），Postman 后端自动转换 - 若只有本地 JSON 文件，先用官方工具转换：
npx openapi-to-postmanv2 -s swagger.json -o collection.json，再导入生成的collection.json - 别信“手动改字段名就能用”——
paths→item、components.schemas这些字段 Postman 不消费，硬改只会让结构更不合法
环境变量 JSON 导入后变量不生效？检查顶层 key
导入后变量面板里显示为空，或请求中 {{host}} 渲染失败，常见原因是 JSON 多套了一层：
- ✅ 正确格式：
{"host": "https://dev.api", "timeout": 5000} - ❌ 错误格式：
{"environment": {"host": "https://dev.api"}}或[{"host": "..."}] - 导入后务必点开环境面板右上角
⋯ → Edit，确认所有变量都列在第一级，且值类型是字符串（数字会被转成字符串，但 null/undefined 会丢失） - 如果原始 JSON 来自 Spring Boot 的
application.json，注意删掉"spring": {...}这类框架专用字段
最常被忽略的一点：Postman 的 JSON 导入不校验业务逻辑，只做结构契约验证。哪怕字段名拼错一个字母（比如 "itme" 代替 "item"），也不会报具体哪行错，只给一句模糊的 invalid collection format。建议导入前用 jq empty your-collection.json 或在线 jsonlint 先过一遍语法，比在 Postman 里反复试成本低得多。
