自定义变量

信息

功能可用范围

以下套餐提供自定义变量：

只有实例所有者和管理员可以创建变量。

自定义变量是只读变量，可用于在 n8n 工作流中存储和复用值。

注意

变量的作用范围和可用性

创建变量

可以从概览页面或某个项目进入 Variables（变量） 标签页。

创建变量的步骤如下：

在 Variables（变量） 标签页选择 Add Variable（添加变量）。
输入 Key（键） 和 Value（值）。键最长 50 个字符，值最长 1000 个字符。n8n 将键和值可用的字符限制为大小写字母、数字和下划线（A-Z、a-z、0-9、_）。
选择 Scope（作用范围）（仅从概览页面创建时可用）：
- Global（全局）：变量适用于实例中的所有项目。
- Project（项目）：变量仅适用于某个指定项目，可以自行选择项目。
- 从项目页面创建时，作用范围会自动设为该项目。
选择 Save（保存）。变量即可在作用范围内的工作流中使用。

编辑或删除变量的步骤如下：

可以在 Code 节点和表达式¹中访问变量：

// Access a variable
$vars.<variable-name>

所有变量都是字符串。

工作流执行时，n8n 会用变量值替换变量。如果变量没有值，n8n 将其视为 undefined，这种情况下工作流不会自动失败。

信息

变量优先级

项目变量与全局变量具有相同键时，项目变量优先，在该项目的工作流中覆盖全局变量值。

变量是只读的，必须通过界面更改值。如果需要在工作流中设置并访问自定义数据，请使用工作流静态数据。