n8n保姆级教程：5分钟手把手拆解Code节点4种用法，小白也能秒懂 - 知识铺

大家好，我是莎姐

n8n中有个非常强大也复杂的节点，那就是Code节点。

当内置节点无法满足需求时，你可能需要它…

当数据需要复杂的处理时，你可能需要它…

当数据条件逻辑过于复杂事，你可能需要它…

今天来带大家拆解一下Code节点的几种简单的用法。

这个n8n工作流主要用到了4个code节点，每个code节点处理数据的功能都不一样。

最后也会拆解Code节点的两种执行模式和使用Code节点的场景

1. Start Tutorial (手动触发器)

类型: manualTrigger

功能: 工作流的起始点，手动触发执行

2. Sample Data (Set节点)

类型: n8n-nodes-base.set

功能: 创建示例用户数据

数据结构: 包含4个用户，每个用户有firstName、lastName、birthDate字段

3. Split Out Users (分割节点)

类型: n8n-nodes-base.splitOut

功能: 将用户数组分割成单独的项目，为后续逐个处理做准备

关键参数: fieldToSplitOut: “users”

4. Process Each User (Code节点 - 基础)

模式: runOnceForEachItem (为每个项目运行一次)

功能:

计算用户全名 (firstName + lastName)
根据出生日期计算年龄

演示基本的数据处理和转换

5. Fetch External Data (Code节点 - 高级)

模式: runOnceForEachItem

功能: 调用外部API (genderize.io) 根据名字猜测性别，

演示this.helpers.httpRequest的使用

6. Calculate Average Age (Code节点 - 聚合)

模式: runOnceForAllItems (为所有项目运行一次)

功能:

使用$items()获取所有用户数据计算平均年龄演示数据聚合操作

7. Create Binary File (Code节点 - 专家级)

模式: runOnceForAllItems

功能: 生成CSV格式的用户报告使用this.helpers.prepareBinaryData创建二进制文件

💡 关键技术点

Code节点的两种执行模式：

runOnceForEachItem: 为每个输入项目单独执行

runOnceForAllItems: 为所有项目执行一次（默认模式）

Run Once for Each Item (为每个项目运行一次)

工作原理：

代码会为每个输入项目单独执行一次
每次执行时，只能访问当前正在处理的那一个项目
输出的项目数量通常等于输入的项目数量

数据访问方式：

<span data-cacheurl="" data-remoteid="" data-lazy-bgimg="https://mmbiz.qpic.cn/mmbiz_svg/kiaXicXJs2M4dKWOu9ZDkkTwxKBEFQLcDic8QwJy3P2zvUANricaicYgXe5p5wHbPusgCfg53FFklbqcaNaGCrUAqnACibQjuh0Zj7/640?wx_fmt=svg&amp;from=appmsg" data-fail="0"></span><code><span leaf="">// 获取当前项目的数据</span><br><span leaf="">const currentItem =&nbsp;</span><span><span leaf="">$input</span></span><span leaf="">.item.json;</span><br><br><span leaf="">// 返回单个项目</span><br><span><span leaf="">return</span></span><span leaf="">&nbsp;{</span><br><span leaf="">&nbsp; ...currentItem,</span><br><span leaf="">&nbsp; newField:&nbsp;</span><span><span leaf="">"新增字段"</span></span><br><span leaf="">};</span><br><br></code>

Run Once for All Items (为所有项目运行一次)

工作原理：

代码只执行一次，但可以访问所有输入项目
可以对所有数据进行聚合、分析或批量处理
输出可以是任意数量的项目

数据访问方式：

<span data-cacheurl="" data-remoteid="" data-lazy-bgimg="https://mmbiz.qpic.cn/mmbiz_svg/kiaXicXJs2M4dKWOu9ZDkkTwxKBEFQLcDic8QwJy3P2zvUANricaicYgXe5p5wHbPusgCfg53FFklbqcaNaGCrUAqnACibQjuh0Zj7/640?wx_fmt=svg&amp;from=appmsg" data-fail="0"></span><code><span leaf="">// 获取所有项目的数组</span><br><span leaf="">const allItems =&nbsp;</span><span><span leaf="">$items</span></span><span leaf="">();</span><br><br><span leaf="">// 可以返回单个项目、多个项目或空数组</span><br><span><span leaf="">return</span></span><span leaf="">&nbsp;[</span><br><span leaf="">&nbsp; {</span><br><span leaf="">&nbsp; &nbsp; json: {</span><br><span leaf="">&nbsp; &nbsp; &nbsp; summary:&nbsp;</span><span><span leaf="">"处理结果"</span></span><span leaf="">,</span><br><span leaf="">&nbsp; &nbsp; &nbsp; totalCount: allItems.length</span><br><span leaf="">&nbsp; &nbsp; }</span><br><span leaf="">&nbsp; }</span><br><span leaf="">];</span><br><br></code>

⚡ 异步操作的重要作用

为什么需要异步（async/await）？

网络请求的本质特性：

<span data-cacheurl="" data-remoteid="" data-lazy-bgimg="https://mmbiz.qpic.cn/mmbiz_svg/kiaXicXJs2M4dKWOu9ZDkkTwxKBEFQLcDic8QwJy3P2zvUANricaicYgXe5p5wHbPusgCfg53FFklbqcaNaGCrUAqnACibQjuh0Zj7/640?wx_fmt=svg&amp;from=appmsg" data-fail="0"></span><code><span leaf="">// ❌ 错误方式 - 同步思维</span><br><span leaf="">const response = this.helpers.httpRequest({ url:&nbsp;</span><span><span leaf="">'https://api.example.com'</span></span><span leaf="">&nbsp;});</span><br><span leaf="">console.log(response); // 这里会得到Promise对象，不是实际数据</span><br><br><span leaf="">// ✅ 正确方式 - 异步处理</span><br><span leaf="">const response = await this.helpers.httpRequest({ url:&nbsp;</span><span><span leaf="">'https://api.example.com'</span></span><span leaf="">&nbsp;});</span><br><span leaf="">console.log(response); // 这里得到实际的API响应数据</span><br><br></code>