自定义变量#
功能可用性
- 仅适用于自托管企业版和专业版云套餐
- 仅实例所有者和管理员可创建变量
自定义变量是只读变量，可用于在 n8n 工作流中存储和重复使用值。
变量作用域与可用性
- 全局变量 对 n8n 实例中的所有用户和所有项目均可用
- 项目作用域变量 仅在其创建的特定项目内可用
- 项目作用域变量在 1.118.0 及以上版本中可用，旧版本仅支持通过左侧菜单访问的全局变量
创建变量#
可通过概览页面或特定项目访问 变量 标签页。
创建新变量步骤：
- 在 变量 标签页中，选 择 添加变量
- 输入 键 和 值。键最大长度为50字符，值最大长度为1000字符。n8n限制键值只能使用大小写字母、数字和下划线（
A-Z、a-z、0-9、_） - 选择 作用域（仅当从概览页面创建时可用）：
- 全局：变量在 n8n 实例的所有项目中可用
- 项目：变量仅在特定项目内可用（可选择具体项目）
- 从项目页面创建时，作用域自动设置为该项目
- 选择 保存。变量将根据其作用域在工作流中可用
编辑和删除变量#
编辑或删除变量步骤：
- 在 变量 标签页中，悬停于目标变量上方
- 选择 编辑 或 删除
在工作流中使用变量#
可通过代码节点和表达式访问变量：
// Access a variable $vars.
<variable-name>
所有变量均为字符串类型。
在工作流执行过程中，n8n会将变量替换为对应的变量值。若变量未赋值，n8n会将其视为undefined。此种情况下工作流不会自动失败。
变量优先级规则
当项目级变量与全局变量使用相同键名时，项目级变量值将优先生效，并在该项目的工作流中覆盖全局变量值。
变量均为只读属性，必须通过用户界面修改其数值。如需在工作流中设置并访问自定义数据，请使用工作流静态数据。