Skip to content

Custom variables 自定义变量#

Feature availability 功能可用性

  • 在自托管企业版和 Pro 云计划中可用。
  • 只有实例所有者和 Admin 可以创建变量。

自定义变量是只读变量，你可以在 n8n 工作流中使用它们来存储和重用值。

Variable scope and availability 变量作用域和可用性

  • Global variables 全局变量对你的 n8n 实例上的所有人可用，跨所有项目。
  • Project-scoped variables 项目作用域变量仅在创建它们的特定项目内可用。
  • 项目作用域变量在 1.118.0 及更高版本中可用。早期版本仅支持从左侧菜单访问的全局变量。

Create variables 创建变量#

你可以从概览页面或特定项目访问 Variables 变量标签页。

要创建新变量：

  1. 在 Variables 变量标签页上，选择 Add Variable 添加变量。
  2. 输入 Key 键和 Value 值。最大键长度为 50 个字符，最大值为 1000 个字符。n8n 限制你在键和值中使用的字符为小写和大写字母、数字和下划线（A-Z、a-z、0-9、_）。
  3. 选择 Scope 作用域（仅在从概览页面创建时可用）：
    • Global 全局：变量在 n8n 实例的所有项目中可用。
    • Project 项目：变量仅在特定项目内可用（你可以选择哪个项目）。
    • 从项目页面创建时，作用域自动设置为该项目。
  4. 选择 Save 保存。变量现在可根据其作用域在工作流中使用。

Edit and delete variables 编辑和删除变量#

要编辑或删除变量：

  1. 在 Variables 变量标签页上，将鼠标悬停在要更改的变量上。
  2. 选择 Edit 编辑或 Delete 删除。

Use variables in workflows 在工作流中使用变量#

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

1
2
// 访问变量
$vars.<variable-name>

所有变量都是字符串。

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

Variable precedence 变量优先级

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

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