Folder 是业务模块最小单位,应按主域和子场景分层命名(如 Auth/Login),禁用空格特殊符;请求需带方法前缀(如 GET_User_List);变量与脚本全局生效,须用 pm.info.folderName 判断逻辑。

用 Folder 实现模块化分组,不是靠 Collection 堆数量
Collection 是项目级容器,Folder 才是业务模块的最小单位。很多人一上来就为每个接口建一个 Collection,结果几百个 Collection 堆在侧边栏,根本没法维护。真正合理的做法是:一个业务系统建 1 个 Collection,再按模块建 Folder,比如 UserService、OrderManagement、PaymentGateway。
Folder 支持嵌套,但建议最多两层:第一层是主域(如 Auth),第二层是子场景(如 Login、ResetPassword)。超过两层会削弱可读性,也影响后续批量运行时的路径识别。
- 新建 Folder:右键 Collection → Add folder,命名直接用业务术语,避免缩写或拼音(别用
UerLogin,用User_Login) - 拖拽移动:请求可以随时拖进 Folder,也能跨 Folder 拖动,但不能把 Folder 拖进另一个 Folder 的“请求列表区”——必须拖到 Folder 标题上才生效
- Folder 本身不保存环境或变量,所有变量仍由 Collection 或 Environment 统一管理
Folder 名称要能被搜索和脚本引用,别用空格和特殊符号
Postman 的搜索框(左上角放大镜)和 Newman 命令行执行都依赖 Folder 名称做匹配。如果写成 User Login (v2),搜索时得输全称加括号;用 User_Login_v2 就能搜 User 或 v2 都命中。更关键的是,Tests 脚本里调用 pm.info.folderName 获取当前 Folder 名时,空格和括号会导致字符串处理异常。
Postman Mac版是一款专为macOS设计的API开发与测试工具,凭借简洁的界面和强大的功能,深受开发者喜爱。它支持发送各种HTTP请求(GET、POST、PUT等),轻松管理接口集合、环境变量和模拟服务器。Mac用户可享受原生性能、快捷键优化及与系统无缝集成的体验,适用于接口调试、自动化测试和文档生成。无论是个人项目还是团队协作,Postman for Mac都能提升API开发效率,是ma
- 推荐命名规则:
大驼峰_下划线_版本号,例如Product_Search_ByKeyword、Inventory_Adjustment_Batch - 禁止使用:空格、中文括号()、斜杠 /、点号 .、星号 * —— 这些在 Newman 的
--folder参数里会报错或截断 - 大小写敏感:
user_login和User_Login是两个不同 Folder,批量运行时指定错一个字母就跳过整组
Folder 内请求的命名必须带方法前缀,否则排序和定位全乱
Postman 默认按字母序排列 Folder 内请求,如果都叫 创建用户、查询用户、删除用户,GET/POST/DELETE 请求混在一起,调试时极易选错。加上方法前缀后,GET_User_List、POST_User_Create、DELETE_User_ByUid 既能按 HTTP 方法聚类,又方便用 Ctrl+F 快速筛选。
- 统一格式:
[METHOD]_[Domain]_[Action]_[KeyParam?],例如GET_Order_Detail_ByOrderId、PUT_Product_Price_Update - KeyParam 只保留最关键的标识字段,避免过长(不用
GET_User_Profile_ByUserId_And_Timestamp,留ByUserId就够) - 同一 Folder 下不要出现重复 Action,比如不能同时有
POST_User_Create和POST_User_Add—— 这说明接口语义没对齐,该找开发对文档
Folder 不是隔离区,变量和测试脚本仍全局生效
新手常误以为把请求放进 Folder 就自动继承了独立变量或断言逻辑。实际上 Folder 不提供作用域隔离:Environment 变量、Globals、Pre-request Script、Tests 脚本全部跨 Folder 生效。这意味着你在 Auth Folder 里写的 pm.variables.set("token", ...),会在 Order Folder 的请求里直接可用——这既是便利,也是隐患。
- 敏感变量(如
admin_token)建议用 Environment 变量 + 不同环境切换,而不是靠 Folder 隔离 - Tests 脚本里若需区分模块逻辑,用
pm.info.folderName === "User_Login"做条件判断,别硬编码路径 - Pre-request Script 中清理变量(如
pm.variables.unset("temp_id"))应在每个请求开头显式做,不能指望 Folder 自动重置
Folder 的价值不在视觉整理,而在构建可批量执行、可搜索、可脚本化引用的业务单元。一旦命名和结构松散,后期用 Newman 做 CI 回归或导出 OpenAPI 文档时,就会卡在路径解析和标签匹配上。

















