全局/环境/模块/临时变量
什么是变量
{{my_token}}，在接口中直接引用。当 token 变化时，只需更新变量值，所有引用该变量的地方会自动同步。变量类型与优先级
临时 > 测试数据 > 环境 > 模块 > 项目全局 > 团队全局。id 的环境变量和一个同名的模块变量，执行接口时将使用环境变量的值。JSON.stringify() 转换，读取时用 JSON.parse() 解析。全局变量
1.
2.
3.
模块变量
环境变量
测试数据变量
临时变量
远程值和本地值
🔗 可重新绑定到远程值。本地值 仅存储在本地，使用清理软件清除 Apifox 文件缓存时，可能会导致 本地值 被删除，请谨慎操作。本地值 不会随账号自动迁移。你可以通过导出和导入环境功能来迁移本地值。本地值 存储在浏览器的数据中。在 Apifox CLI 中使用变量
本地值，而在 CLI 中运行时使用的是变量的 远程值。如果客户端和 CLI 的运行结果不同或出现错误，通常是由于这一差异导致的。设置变量
方法 1：在 “环境管理” 中设置
点击界面右上角的 “环境管理” 按钮
≡切换到 “全局变量” 或特定环境
添加变量名、远程值和本地值
点击
保存方法 2：通过 “提取变量” 设置
在运行标签页（文档模式）或请求标签页（调试模式）中，导航到后置操作
光标悬停在 “添加后置操作” 上并选择 “提取变量”
输入变量名并选择变量类型。选择提取来源，如响应 JSON、响应 XML 或响应文本等。
如果响应是 JSON/XML 格式，你可以使用 JSONPath/XPath 语法解析响应 JSON/XML 的特定部分，并将其保存为变量值。
发送请求后，变量提取会被执行，你可以在控制台查看日志，然后在相关的 “环境管理” 中查看该变量。
方法 3：在 “脚本” 中设置
set 方法设置变量。以下是示例代码：set 的语法：1.
JSON.parse 逆转换。2.
3.
4.
方法 4：将 “数据库数据” 设置为变量
在运行标签页（文档模式）或请求标签页（调试模式）中，导航到后置操作。
悬停在 “添加后置操作” 上并选择 “数据库操作”。
为数据库操作命名并设置数据库连接。
输入 SQL 命令。命令中支持使用变量，如
{{variables}}。设置 “提取结果到变量”，支持使用 JSONPath，这样会将查询到的数据库数据存储到环境变量或者其他类型的变量中。也可以开启 “控制台打印结果” 开关，以将结果打印到控制台。
点击发送请求，你可以在控制台查看数据库操作的结果。
使用变量
my_token 的变量，只需将变量名用双大括号包裹，如：{{my_token}}。http://127.0.0.1/pet/findByStatus?status={{CurrentStatus}}CurrentStatus 变量的存储值。如果 CurrentStatus 的值是 "available"，发送的请求 URL 会包含查询参数：http://127.0.0.1/pet/findByStatus?status=available{
"status" : "{{CurrentStatus}}"
"quantity" : {{TotalPet}}
}访问变量的子元素值
{{变量名.属性名}} 或 {{变量名[0].属性名}} 读取变量中的字段值。例如：1.
user 如下：{{user.name}} 引用 user 对象的 name 字段pm.variables.get("user.name") 引用 user 对象中的 name 字段2.
user 如下：{{user[0].name}} 引用 user 数组第一个元素的 name 字段pm.variables.get("user[0].name") 引用 user 数组第一个元素的 name 字段{{user.name}} 这样的方式读取变量（对象或数组）中的字段值遵循 JSONPath 语法规范。你可以用变量名替换 JSONPath 中的 $ 符号。在脚本中使用变量
{{变量}} 语法。需要先通过 get 方法将变量值赋给一个新的变量。以下是示例代码：get 的语法：1.
JSON.parse 逆转换。2.
3.
4.
打印变量值
使用测试数据变量
{{变量名}} 引用这些数据变量，其中变量名对应 CSV 中的列名。{{变量}} 会被替换为实际数据。每行数据对应一次请求执行，测试报告中将显示每次运行的请求和响应。常见问题
{{变量}}。pm.environment.get("变量名") 或类似语句引用变量，但不能直接使用 {{变量}}。{{变量}}。