Postman v2.1是导出兼容性底线，被Postman 7.x–10.x、Apifox 3.x+、Newman 5.x+原生支持；v2.0缺schema报错，v3丢tests/event；导出前须清草稿、固化环境变量current_value、改chai断言为pm.test、确保item嵌套正确。
Postman v2.1 导出格式是兼容性底线
Postman 集合 JSON 文件的 schema 版本直接决定能否被 Apifox、Newman 或旧版 Postman 正确解析。v2.1 是目前最稳妥的选择——它能被 Postman 7.x 至 10.x、Apifox 3.x+、Newman 5.x+ 原生识别，而 v2.0 或 v3 格式在部分工具中会丢弃 tests 脚本或环境变量作用域。
导出时务必手动选 v2.1，不要依赖默认选项。如果你看到导出文件里 "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"，才算落了地。
- 用 v3 导出 → Apifox 可能跳过所有
tests和event脚本 - 用 v2.0 导出 → Newman 5.0+ 会报
Invalid collection JSON: missing info.schema - 导出前先清空集合里未保存的草稿请求，否则 v2.1 仍可能包含不规范的
id字段导致 Apifox 解析失败
环境变量导入后值为空？检查 values 数组里的 current_value
Postman 环境变量导出时只存 initial value，不存运行时的 current value。你导出前刚在 Postman 里切换了环境、改了 api_base_url 的当前值，但导出文件里 value 字段还是旧的初始值——这就是导入后“变量名在、值为空”的根源。
验证方法：打开导出的 .json 文件，搜索 "values"，看每个变量的 value 是否是你期望的当前值。如果不是，说明你没在导出前把当前值同步为初始值。
- 补救操作：在 Postman 中打开该环境 → 点击右上角
⋯→ 选Set as initial value - 批量同步：用脚本读取导出文件，把
value替换为当前想固定的值，再重新导入 - 别依赖“导出即生效”——环境变量本质是本地会话状态，跨设备迁移必须显式固化
tests 脚本执行报 ReferenceError：chai 未定义
Postman 8.0+ 默认禁用了全局 chai 对象，老集合里写的 chai.expect(...).to.be.true 会直接报错；而 tests["xxx"] = pm.response.code === 200 这类原生写法不受影响。
Postman 12.27.7 Windows x64 官方安装包，适用于 API 设计、调试、测试与协作。该系列包含 Enterprise 云端性能测试静态 IP 出口能力，以及接口规范标签管理改进，适合受限网络测试与规范资源组织场景。
这不是版本 bug，是安全策略升级。如果你的集合是从 6.x 升级上来、且含大量 chai 断言，导入后所有 tests 都会静默失败（控制台报错但不提示）。
- 快速检测：在任意请求的
Tests标签页粘贴console.log(typeof chai);，返回undefined就确认被禁用 - 兼容写法：改用
pm.test("status code is 200", () => { pm.response.to.have.status(200); }); - 临时启用（不推荐）：在 Pre-request Script 里加
eval(pm.collectionVariables.get("chaiScript"));，但违反沙箱原则，CI 场景下会被 Newman 拒绝
导入后请求顺序乱、分组丢失？检查 collection.json 的 item 数组嵌套
Postman 集合的结构依赖 item 数组的嵌套层级表达文件夹和请求关系。如果导出时用了非官方工具（比如某些 Swagger 转换器），生成的 JSON 可能扁平化所有 item，导致 Apifox 或新版 Postman 无法还原原始分组。
典型症状：导入后所有请求平铺在根目录，子文件夹消失；或者请求顺序和 Postman UI 里显示的完全不一致。
- 手动修复：打开 JSON，找到
"item": [ ... ]，确认每个子文件夹对象是否含"item"字段，且内部请求正确嵌套其中 - 避免中间转换：不要用在线 Swagger-to-Postman 工具导出，优先用 Postman 自带的
Import → Import from Link / File直接加载 OpenAPI 3.0 YAML - 验证工具：用
jq '.item[] | select(has("item"))' exported.json快速检查是否存在嵌套结构
真正容易被忽略的是：集合导入不是“复制粘贴”动作，而是对变量作用域、脚本执行上下文、甚至请求 ID 生成规则的一次重建。哪怕格式完全合规，只要环境变量没固化、tests 没适配新沙箱、item 嵌套有偏差，结果就不可信。
