Postman集合中创建文件夹核心目的是控制执行顺序、共享预请求脚本、统一断言和复用变量;需通过集合右侧“…”菜单选择Add Folder,而非右键或顶部New按钮;文件夹级脚本和变量仅对显式保存至该文件夹的请求生效,且嵌套建议不超过两层以避免CI解析异常和可维护性下降。

Postman 集合里创建文件夹不是为了“分类好看”,而是为了控制执行顺序、共享预请求脚本、统一加断言和复用变量——不建文件夹,后续批量运行或写测试逻辑时会很快失控。
点击集合右侧的 … 菜单再选 Add Folder
别在侧边栏空白处右键,也别点顶部“New”按钮——那只会新建集合,不是文件夹。正确路径是:找到目标集合(比如 user-api-v2),鼠标悬停或点击它右侧的三个点 … 图标,弹出菜单后选 Add Folder。这时会弹出一个轻量对话框,只要填 Name(必填)和可选的 Description 就能完成。注意:Authorization、Pre-request Script、Tests 这些字段此时就生效了,它们作用于该文件夹下所有请求,不是摆设。
文件夹里的请求必须显式保存进去,不会自动归属
很多人以为把请求拖进文件夹就“属于”它了,其实只是视觉排序。真正归属要靠保存动作:
Postman 12.27.7 Windows x64 官方安装包,适用于 API 设计、调试、测试与协作。该系列包含 Enterprise 云端性能测试静态 IP 出口能力,以及接口规范标签管理改进,适合受限网络测试与规范资源组织场景。
- 新建请求后,点右上角
Save,在弹窗中手动选择目标集合 → 目标文件夹 - 从
History恢复请求时,悬停在历史项上点+,同样要主动选到具体文件夹下 - 如果只选了集合没选文件夹,请求会挂在集合根目录,后续跑
Run时它也会被执行,但拿不到文件夹级的Pre-request Script和Tests
文件夹嵌套有实际限制,别过度分层
Postman 支持子文件夹(即文件夹里再 Add Folder),但深度超过 2 层后会出现两个问题:
-
Run窗口里无法单独选中第 3 层子文件夹执行,只能全量跑父集合或第 2 层 - 导出为
Collection v2.1JSON 后,某些 CI 工具(如 Newman 5.x)解析时可能忽略深层嵌套结构,导致脚本丢失 - 团队协作时,路径太深(如
auth → login → wechat → v3)反而降低可读性,建议用语义化命名替代深度,例如login-wechat-v3放平级
重命名或移动文件夹后,记得检查变量引用是否断裂
文件夹名本身不参与运行,但如果你在 Pre-request Script 或 Tests 里写了类似 pm.collectionVariables.set("folder_id", "auth") 这种硬编码逻辑,改名后不会自动同步。更隐蔽的是环境变量覆盖场景:如果在文件夹级设置了 base_url,又在某个请求里手动覆盖了 URL,那个请求就不再受文件夹变量影响——这种“局部逃逸”容易被忽略,调试时建议用 console.log(pm.variables.toObject()) 快速确认当前生效变量源。

















