『n8n』遍历节点 Loop Over Items 的用法

在 n8n 的自动化流程中，处理**数据集（Items）**是核心任务。当你的前置节点输出了多条数据（例如从数据库读取了 10 行记录，或从 Gmail 获取了 5 封邮件），而你需要对每一条数据执行相关步骤的操作时，就需要用到“遍历”机制。

在 n8n 中遍历节点叫「Loop Over Items」，是 n8n 核心内置节点之一，用于实现可控的循环迭代处理数据，尤其适合批量数据处理。

本文用一个简单的工作流讲解一下「Loop Over Items 节点」的用法。

在 Data tables 里有一张「员工信息」表，里面有3名员工信息。

我要用「Loop Over Items 节点」将表里的员工姓名遍历输出在浏览器控制台。

先看看工作流：

使用「Data table 节点」读取员工信息表。

「Loop Over Items 节点」的“Batch Size”填1，表示遍历1次。「员工信息表」有3条数据，也就是将这3条数据遍历出来，执行3次。

如果“Batch Size”填2，那就是遍历2次，表里有3条数据的话就是执行6次。

按需选择，遍历1次是比较常见的。

“Reset”可以关掉。如果开启它的话就需要自己写遍历条件，遇到什么条件才终止遍历。如果没有特别要求，但又开启了“Reset”并且没有终止条件的话就会进入死循环。

「Loop Over Items 节点」有2个输出端口，done 是遍历结束后会走的端口，loop 是每次遍历都会走的端口。

在这个例子中，loop 端接的是一个 Code 节点，使用 console.log() 方法把员工姓名 name 输出到浏览器控制台。

done 端口也是接了一个「Code 节点」，它等到「Loop Over Items 节点」遍历完成后在控制台输出一句 遍历结束。

完成工作流配置后，按 F12 打开浏览器控制台，然后运行整个工作流就可以在控制台看到3条员工姓名以及一条“遍历结束”的输出。

运行工作流后可以看到，「Loop Over Items 节点」右下角有个 4 字，表示它运行了4次（3次 loop，1次 done），loop 端口连接的「Code 节点」运行了3次。