自定义变量#

功能可用性

• 在自托管企业版和 Pro 云端计划中可用。
• 您需要拥有 n8n 实例的管理员账户权限才能创建和编辑变量。所有用户都可以使用已存在的变量。

适用于版本 0.225.0 及以上版本。 自定义变量（Custom variables）是只读变量，可用于在 n8n 工作流中存储并复用值。 变量是共享的 当您创建一个变量后，该变量将对您的 n8n 实例中的所有用户可用。

创建变量#

要创建新变量，请执行以下操作：

1. 在 变量（Variables） 页面上，选择 添加变量（Add Variable）。
2. 输入 键（Key） 和 值（Value）。最大键长度为 50 个字符，最大值长度为 220 个字符。n8n 限制键和值中可使用的字符为大小写字母、数字和下划线（A-Z、a-z、0-9、_）。
3. 选择 保存（Save）。该变量现在即可在 n8n 实例的所有工作流中使用。

编辑和删除变量#

要编辑或删除变量：

1. 在 变量（Variables） 页面上，将鼠标悬停在您想要修改的变量上。
2. 选择 编辑（Edit） 或 删除（Delete）。

在工作流中使用变量#

您可以在代码节点（Code node）以及 表达式（expressions） 中访问变量：

1
2

| ``` // 访问一个变量 $vars.

---|---
所有变量均为字符串类型。
在工作流执行期间，n8n 会将变量替换为其对应的值。如果变量没有设置值，n8n 会将其视为 `undefined`。在这种情况下，工作流不会自动失败。
变量是只读的，必须通过 UI 界面更改其值。如果您需要在工作流内部设置和访问自定义数据，请使用 工作流静态数据（Workflow static data）。