Postman接口迁移Apifox需分三步：先导入集合文件（v2.1格式），再单独迁移环境与全局变量（转为Apifox环境+变量组合），最后适配测试脚本（替换pm.为apifox.并调整断言语法）。
要把Postman里积攒的接口集合、环境变量和测试脚本完整迁移到Apifox，避免手动重录耗时出错，必须分三步走：先搬集合结构，再补变量映射，最后校验脚本执行逻辑。直接复制粘贴会丢失请求间依赖关系，导致自动化测试跑不通。
导入Postman集合文件
这一步只处理接口结构和基础配置，不包含任何变量或脚本运行上下文。
在Postman中打开目标集合 → 点击集合右侧「⋯」→ 选择「Export」→ 勾选「Collection v2.1（recommended）」→ 保存为my-api-collection.json。
登录Apifox → 进入目标项目 → 左侧边栏点击「项目设置」→「导入数据」→「Postman」→ 将刚导出的JSON文件拖入上传区或点击选择文件。
上传后系统自动解析，预览窗口中会显示接口数量、文件夹层级和是否含Pre-request Scripts/Tests。确认无误后点击「导入」。
【注意：Postman的集合变量会被自动转为Apifox全局变量，但全局变量和环境变量不会随集合文件一起导出，必须单独迁移】
迁移Postman环境与全局变量
Postman中的环境变量（如dev/staging/prod）和全局变量（如token、base_url）在Apifox中需重建为“环境”+“环境变量”组合，否则所有接口发出去都是404或401。
方法一：手动重建环境
在Postman中依次进入「Environments」→「Globals」→ 点击右上角「Export」→ 保存为globals.json；再对每个环境（如dev）点击右侧「⋯」→「Export」→ 保存为dev.json、staging.json等。
在Apifox中进入「环境管理」→「新建环境」→ 输入环境名（如development）→ 在「环境变量」区域点击「导入变量」→ 上传对应dev.json文件。
方法二：用Apifox变量映射表快速对齐
Apifox Linux 桌面版是一款专为 Linux 开发者打造的 API 一体化工具，集接口设计、调试、测试、Mock 和文档管理于一体。它在 Linux 环境下提供稳定、高效的本地运行体验，帮助开发者实现 API 全生命周期管理，是 Linux 开发者进行接口开发与联调的高效工具。
打开Apifox「环境管理」→「变量映射」→ 粘贴Postman环境变量原始键值对（例如baseUrl → https://api.dev.example.com）→ 系统自动生成Apifox格式的变量定义 → 点击「应用到当前环境」。
① 检查变量引用是否生效：在任意接口的URL栏输入{{baseUrl}}/users，切换环境后应实时变更为对应域名。
② 删除Postman遗留的硬编码URL：比如原请求URL是https://dev.api.com/v1/login，必须改成{{baseUrl}}/v1/login，否则环境切换无效。
③ 全局变量（如auth_token）要设为「全局变量」类型，而非环境变量，确保跨环境复用。
验证并适配测试脚本
Postman的Tests脚本在Apifox中基本可直接运行，但有两处关键差异必须手动调整，否则断言永远失败。
方法1：检查pm.test()语法兼容性
Apifox支持Postman v3.x语法，但不支持pm.response.to.have.status(200)这种链式写法。需改为pm.expect(pm.response.code).to.eql(200)。
方法2：替换pm.environment.set()为Apifox变量写法
Postman中常通过pm.environment.set("user_id", jsonData.id)传递参数，Apifox中对应写法是apifox.setEnvVar("user_id", jsonData.id)。不改会导致后续接口拿不到动态值。
打开Apifox中已导入的任一接口 → 切换到「测试」标签页 → 点击「Tests」→ 找到含pm.environment或pm.globals的行 → 替换为apifox.setEnvVar或apifox.setGlobalVar。
运行单个接口测试 → 查看「测试结果」面板中绿色勾数量 → 若出现ReferenceError: pm is not defined，说明仍有未替换的Postman专属对象调用。
