为节点创建者提供的项目链接#

仅适用于编程式节点 本指南适用于编程式节点（programmatic-style nodes）。如果你使用的是声明式节点（declarative style），n8n 会自动为你处理配对项目（paired items）。

使用 n8n 的项目链接功能，可以访问当前项目之前的数据项。n8n 需要知道每一个输出项目来源于哪个输入项目。如果缺少此信息，其他节点中的表达式可能会出错。作为节点开发者，你必须确保你的节点返回的所有项目都支持这一机制。

这适用于所有编程式节点（包括触发器节点 trigger nodes）。在构建声明式节点时，无需考虑项目链接问题。有关节点类型的更多说明，请参阅 选择你的节点开发方式。

首先阅读 项目链接概念，该页面提供了项目链接的总体概念，并详细说明了 n8n 能够自动处理链接的各种场景。

如果你需要手动处理项目链接，则应在你的节点返回的每个项目上设置 pairedItem：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20

| ``` // 使用传入项目的 pairedItem 信息 newItem = { "json": { ... }, "pairedItem": { "item": item.pairedItem, // 可选：指定使用的输入 // 如果你的节点合并了多个输入，请设置此项 "input": 0 } };

// 或者手动设置索引 newItem = { "json": { ... }, "pairedItem": { "item": i, // 可选：指定使用的输入 // 如果你的节点合并了多个输入，请设置此项 "input": 0 } };

---|---