[!info] related notes

• 所属 MOC: postman-moc
• 前置概念: postman-api-client-basics
• 易混淆概念: postman-scripts-tests-and-runner
• 相关资源: postman

Postman 的 Collections、Environments 与 Variables

范围

这篇笔记聚焦 Postman 的资产组织层，不展开脚本断言和 CLI 自动化。

为什么要放在一起理解

Postman 真正从“手动请求工具”进化到“API 工作台”，关键不在 request 本身，而在于：

• collection 组织一套 API
• environment 切换多套环境
• variables 在请求之间复用和传值

三者合起来，才让 Postman 变成“可执行的 API 说明书”。

依赖路径 / 调用链 / 演进链

1. Collection 是组织核心

Collection 不只是文件夹，它通常承载：

• 请求集合
• collection-level variables
• 统一 auth
• pre-request / tests
• examples
• 文档、mock、runner 的执行基础

2. Environment 解决多环境切换

最典型的变量是：

• {{base_url}}
• {{access_token}}
• {{user_id}}
• {{order_id}}

然后在 local / dev / staging / prod 中切换不同的取值。

3. Variables 解决复用与串联

变量既可以是静态配置，也可以来自上一个请求的响应。

所以一套请求可以被复用于：

• 本地调试
• 测试环境回归
• 生产排障

对比与易混淆点

Collection 不是普通目录

它同时承载请求、变量、文档、测试、示例和自动化执行上下文。

Environment 不只是“换 host”

它也常被用来管理 token、tenant、userId、feature flag 等动态上下文。

Variables 不等于脚本

Variables 负责“数据复用与传递”，scripts 负责“逻辑执行与断言”。