Apidog 支持数据驱动测试,允许你导入 CSV 或 JSON 格式的测试数据集,并在测试请求中使用它们。快速开始#
2
准备测试数据。一组测试数据是一个二维表,其中每一列代表一个变量,每一行包含这些字段的一组值,用于单次测试场景迭代。例如,你可以准备一个包含以下数据的 CSV 文件。
| 数据集名称 | petType | petName | age | price |
|---|
| Pet-1 | Dog | Buddy | 3 | 300 |
| Pet-2 | Cat | Whiskers | 2 | 150 |
| Pet-3 | Bird | Tweety | 1 | 50 |
| Pet-4 | Rabbit | Thumper | 4 | 80 |
| Pet-5 | Dog | Max | 5 | 250 |
3
切换到“测试数据”标签页,点击“新建”以添加一组测试数据。
5
将测试数据变量添加到你的请求中。测试数据变量的名称应与二维表中的列名匹配。
测试数据#
每个测试场景都可以维护多组测试数据,并且你可以在运行场景时选择要使用的数据集。测试数据可以按环境进行配置,因此当你切换到不同环境时,将使用对应的测试数据集。例如,你可以为测试环境和开发环境维护一组宠物数据,并使用相同的变量名称。当你切换环境时,将使用对应环境中的变量值。编辑测试数据#
你可以导入/导出 CSV 或 JSON 格式的测试数据,也可以手动添加和编辑测试数据。使用测试数据#
你可以使用 {{variable}} 将测试数据变量插入到请求参数、头部、主体以及其他位置。运行测试场景时,这些变量将被替换为对应的测试数据值。变量名可能与其他变量相同。当存在重复的变量名时,优先级顺序为:局部变量 > 测试数据变量 > 环境变量 > 全局变量。在脚本中使用测试数据#
pm.iterationData.has(variableName:String): function → Boolean: 检查测试变量是否存在。
pm.iterationData.get(variableName:String): function → *: 获取测试变量。
pm.iterationData.replaceIn(variableName:String): function: 将字符串中的动态变量替换为其实际值。
pm.iterationData.toObject(): function → Object: 将所有局部变量作为对象获取。FAQ#
答:在 Windows 上,Excel 默认会自动使用 GBK 编码保存 CSV 文件。这可能导致在其他软件中查看 CSV 时出现乱码。此外,旧版 Excel(例如 Excel 2016)在将 CSV 保存为 UTF-8 时通常不会保存 BOM(字节顺序标记),这也可能导致乱码。在 Windows 上,将 CSV 重新保存为 UTF-8 编码。
在 macOS 上,运行 iconv -f GBK -t UTF-8 xxx.csv > utf-8.csv 来转换编码。
Modified at 2026-06-09 08:55:47