自定义变量#

功能可用性

• 仅适用于自托管企业版和专业版云套餐
• 仅实例所有者和管理员可创建变量

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

变量作用域与可用性

• 全局变量 对 n8n 实例中的所有用户和所有项目均可用
• 项目作用域变量 仅在其创建的特定项目内可用
• 项目作用域变量在 1.118.0 及以上版本中可用，旧版本仅支持通过左侧菜单访问的全局变量

创建变量#

可通过概览页面或特定项目访问 变量 标签页。

创建新变量步骤：

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

编辑和删除变量#

编辑或删除变量步骤：

1. 在 变量 标签页中，悬停于目标变量上方
2. 选择 编辑 或 删除

在工作流中使用变量#

可通过代码节点和表达式访问变量：

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

所有变量均为字符串类型。

在工作流执行过程中，n8n会将变量替换为对应的变量值。若变量未赋值，n8n会将其视为undefined。此种情况下工作流不会自动失败。

变量优先级规则

当项目级变量与全局变量使用相同键名时，项目级变量值将优先生效，并在该项目的工作流中覆盖全局变量值。

变量均为只读属性，必须通过用户界面修改其数值。如需在工作流中设置并访问自定义数据，请使用工作流静态数据。