n8n 中文文档

自定义变量

提示

Feature availability 功能可用性

自定义变量可用于:

  • n8n Cloud: Pro、Enterprise
  • Self-hosted: Business、Enterprise

只有实例所有者和管理员才能创建变量。

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

警告

Variable scope and availability 可变范围和可用性

  • Global variables 全局变量 可供所有项目中 n8n 实例上的所有人使用。
  • Project-scoped variables 项目范围的变量 仅在创建它们的特定项目中可用。
  • 项目范围的变量从 n8n 1.118.0 起可用。以前的版本仅支持从左侧菜单访问全局变量。

创建变量

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

要创建新变量:

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

编辑和删除变量

要编辑或删除变量:

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

在工作流中使用变量

您可以访问代码节点和表达式[^1]中的变量:

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

所有变量都是字符串。

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

提示

Variable precedence 变量优先级

当项目范围的变量与全局变量具有相同的键时,项目范围的变量值优先并覆盖该项目工作流程中的全局变量值。

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

[^1]:在 n8n 中,表达式允许您通过执行 JavaScript 代码动态填充节点参数。您可以使用 n8n 表达式语法,使用来自先前节点、其他工作流程或 n8n 环境的数据来定义值,而不是提供静态值。

相关资源

不想自己部署和维护 n8n?n8ncn 托管 n8n 云服务:开通账号即可使用,不用买服务器;也可以在 n8ncn 工作流库 找现成的中文工作流。