Postman 集合变量使用详解

前言

作为一名测试工程师，在API测试中，Postman 是一款强大的工具。集合变量是 Postman 中的重要功能，能够让测试更加灵活、高效。本文将详细介绍 Postman 集合变量的定义、使用和管理方法，帮助您更好地掌握这项技能。

什么是集合变量

集合变量是定义在 Postman 集合（Collection）范围内的变量，可以在该集合中的所有请求中使用。这使得测试过程更加模块化和动态化，尤其在参数重复使用和环境切换时显得尤为重要。

集合变量的定义

1. 创建集合：

打开 Postman，点击左侧导航栏的“Collections”选项卡，然后点击“Create a collection”按钮，创建一个新的集合。

2. 定义集合变量：

• 在新建的集合上点击右键，选择“Edit”。
• 在弹出的编辑窗口中，选择“Variables”选项卡。
• 在这里，可以添加变量名称（Name）、初始值（Initial Value）和当前值（Current Value）。
• 例如，定义一个名为 baseUrl 的变量，初始值和当前值均设置为 https://api.example.com。

集合变量的使用

1. 在请求中使用变量：

• 创建一个新的请求，选择集合作为其父级。
• 在请求的 URL、Headers、Body 等部分使用变量，变量的格式为 {{variableName}}。
• 例如，在请求 URL 中使用 {{baseUrl}}/users。

2. 测试集合变量：

发送请求，Postman 会自动将 {{baseUrl}} 替换为变量的实际值 https://api.example.com。

集合变量的管理

1. 查看和编辑变量：

• 在集合的“Edit”窗口中，可以随时查看和编辑变量的初始值和当前值。
• 修改后点击“Save”保存更改。

2. 环境切换：

• Postman 支持不同的环境（Environments），环境变量可以与集合变量结合使用。
• 通过环境的“Manage Environments”按钮创建和管理环境变量，并在不同环境间切换。

高级用法

1. 脚本中使用变量：

• Postman 允许在预请求脚本（Pre-request Script）和测试脚本（Tests）中使用集合变量。
• 例如，在预请求脚本中动态修改变量的值：

pm.collectionVariables.set("token", "new_value");

• 在测试脚本中读取变量的值：

const token = pm.collectionVariables.get("token");
console.log(token);

2. 集合变量的作用域：

• 变量的作用域从小到大依次为：全局变量（Global）、环境变量（Environment）、集合变量（Collection）、本地变量（Local）、数据变量（Data）。

• 当多个变量名相同时，Postman 会优先使用作用域较小的变量。

示例

1. 示例请求：

• 创建一个 GET 请求，URL 为 {{baseUrl}}/users。
• 添加一个 Headers，键为 Authorization，值为 Bearer {{token}}。
• 在集合变量中定义 baseUrl 和 token，分别设置为https://api.example.com 和 your_token_here。

2. 运行请求：

• 发送请求，确保变量正确替换，获取用户信息。

总结

通过本文的详细介绍，相信已经掌握了 Postman 集合变量的定义、使用和管理方法。合理利用集合变量，可以显著提高API测试的效率和灵活性。如果在使用过程中遇到问题，可以参考 Postman 官方文档获取更多帮助。