Postman导出的Collection v2.1 JSON文件默认不包含集合变量（variable字段为空或缺失），因其属运行时元数据，需手动注入variable数组并校验JSON语法。
导出的 JSON 文件里到底有没有集合变量
Postman 导出集合时，默认只导出 Collection v2.1 格式，而这个格式**不包含集合变量（Collection Variables）**——这是最容易被忽略的事实。你点“Export”、选 v2.1、保存成功，但打开 JSON 文件一搜 variables 字段，会发现它要么为空，要么根本不存在。
原因很简单：Postman 的集合变量是运行时附加的元数据，不属于集合定义本身；它和环境变量、全局变量不同，没有独立的导出入口，也不会随集合一起打包。
- 检查方法：用文本编辑器或
cat打开导出的.json文件，搜索"variables"—— 如果没匹配到，或只看到"variables": []，说明集合变量确实没导出 - 对比验证：导出一个带环境变量的环境文件（
environment_*.json），里面一定有非空的values数组，结构清晰可辨 - 影响范围：用 Newman 运行该集合时，所有
{{collection_var}}引用都会解析失败，报ReferenceError: collection_var is not defined
想让集合变量一起导出，只能手动补进 JSON
目前 Postman 没提供“导出含集合变量的集合”这一功能，也没有 UI 入口。唯一可靠的方式是导出后，人工把变量注入到 JSON 的 variable 字段中。
操作前先确认你导出的是标准 Collection v2.1 结构：根对象必须有 info、item 字段；然后在同级插入 variable（注意不是 variables）：
Postman Mac版是一款专为macOS设计的API开发与测试工具，凭借简洁的界面和强大的功能，深受开发者喜爱。它支持发送各种HTTP请求（GET、POST、PUT等），轻松管理接口集合、环境变量和模拟服务器。Mac用户可享受原生性能、快捷键优化及与系统无缝集成的体验，适用于接口调试、自动化测试和文档生成。无论是个人项目还是团队协作，Postman for Mac都能提升API开发效率，是ma
{
"info": { ... },
"variable": [
{
"key": "api_version",
"value": "v3",
"type": "string"
}
],
"item": [ ... ]
}
-
variable是数组，每个元素必须含key和value；type可选，但建议显式写"string" - 不能写成
"variables"（这是旧版 v2.0 的字段名，Newman 不认） - 修改后务必用 JSON 校验工具（如 jsonlint.com）检查语法，少个逗号就整个集合加载失败
为什么不用全局/环境变量替代集合变量
看起来都叫“变量”，但作用域和维护成本差异很大：
- 全局变量污染风险高：
pm.globals.set("timeout", "5000")会影响所有集合，协作时极易误覆盖 - 环境变量不适合单集合专用配置：比如某个集合需要专属的
mock_flag=true，但其他集合根本不用，硬塞进环境变量会导致配置膨胀、语义混乱 - 集合变量天然隔离：只在本集合内生效，命名自由（如
order_flow_step1_token），导出时虽需手动补，但逻辑边界最干净
所以不是“不能替代”，而是替代后会让变量体系变脆——尤其当团队共用一套环境变量 JSON 时，谁都不敢轻易删字段。
真正能一键导出全部变量的只有 Data Export 功能
如果你需要完整备份当前工作区的所有状态（包括集合变量、环境、全局、甚至历史请求），得用 Postman 内置的全量导出：Settings → Data → Export Data。
- 导出的是单个
postman_data.json，内部包含collections、environments、globals、collection_variables等完整字段 - 但它不是标准 Collection 格式，无法直接被 Newman 加载运行；仅用于本地备份或迁移工作区
- 恢复方式是
Import Data，不是导入集合——别把它当成集合导出的“升级版”
集合变量的导出，始终是个“半手工”动作。接受这点，比花时间找不存在的自动方案更省力。
