Postman创建Collection需配置Name、Description和Variables三个关键项，其中Variables页签必须定义base_url等变量以支持环境切换，否则后期扩展困难。
Postman 里创建 Collection 不是点一下“New Collection”就完事——关键在初始配置是否留出扩展空间，否则后期加变量、授权、预请求脚本时得反复重开。
Collection 创建时必须填的三个字段
点击侧边栏 New Collection 后弹出的面板里，Name 和 Description 是显性必填项，但真正影响后续协作和复用的是第三个隐性关键项：Variables 页签。很多人跳过它，结果等要切测试/生产环境时才发现没地方统一配 base_url 或 auth_token。
-
Name建议带项目缩写和环境标识，比如crm-api-prod，避免用test、new这类无意义名称 -
Description别留空，哪怕只写一行 “用户模块接口（含登录、权限校验）”，后续导出文档或分享给同事时这就是第一眼看到的上下文 - 进到右侧
Variables页签，至少定义一个base_url变量，值设为{{protocol}}://{{host}}:{{port}}，再在Initial value里填开发环境地址，这样后续切换环境只需改 Environment，不用动每个请求的 URL
把已有请求塞进 Collection 的三种路径及风险点
刚调通一个接口就想保存？别急着点 Save —— 保存路径选错会导致请求脱离上下文，比如变量不生效、测试脚本丢失。
Postman 12.27.7
下载
Postman 12.27.7 Windows x64 官方安装包，适用于 API 设计、调试、测试与协作。该系列包含 Enterprise 云端性能测试静态 IP 出口能力，以及接口规范标签管理改进，适合受限网络测试与规范资源组织场景。
- 从请求构建器（Builder）保存：调试完后点
Save→ 选 “Create a new Collection”，此时会回到新建 Collection 流程，务必手动补全Variables和Pre-request Script再点 Create，否则新集合是裸的 - 从 History 保存：悬停在历史记录上点
+，但注意——如果该请求用了临时设置的 Header 或 Body，这些不会自动转成集合级变量，得手动补到Variables并在请求里改成{{var_name}} - 拖拽保存：直接把标签页拖进左侧 Collection 文件夹里，这种最危险——它不会触发任何初始化逻辑，连
base_url变量都不会自动挂载，适合已有成熟 Collection 时加请求，不适合冷启动
为什么 Collection v2.1 是导出时唯一该选的格式
导出 Collection 时勾选 Collection v2.1 不是凑数，它决定了变量作用域、脚本执行顺序、甚至 Newman 能否正确加载测试断言。
- v1 已废弃，不支持
pm.variables.set()这类动态变量操作 - v2 缺少对嵌套文件夹中
Pre-request Script的独立作用域支持，可能导致子文件夹请求误用父级变量 - v2.1 明确区分了
collection-level、folder-level、request-level三类脚本执行时机，Runner 和 Newman 都默认按此解析；导出时选错版本，CI 流水线里跑newman run会报ReferenceError: pm is not defined
真正容易被忽略的，是 Collection 创建后立刻去点右上角 ... → Edit，检查 Variables 页签里有没有漏掉环境切换必需的字段——不是所有团队都用 base_url，有人依赖 api_version 或 tenant_id，这些一旦上线后再补，就得逐个请求去修 URL 或 Header。
