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 (为每个项目运行一次)

工作原理：

代码会为每个输入项目单独执行一次

每次执行时，只能访问当前正在处理的那一个项目

输出的项目数量通常等于输入的项目数量

数据访问方式：

// 获取当前项目的数据
const currentItem = $input.item.json;

// 返回单个项目
return {
  ...currentItem,
  newField: "新增字段"
};

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

工作原理：

代码只执行一次，但可以访问所有输入项目

可以对所有数据进行聚合、分析或批量处理

输出可以是任意数量的项目

数据访问方式：

// 获取所有项目的数组
const allItems = $items();

// 可以返回单个项目、多个项目或空数组
return [
  {
    json: {
      summary: "处理结果",
      totalCount: allItems.length
    }
  }
];

⚡ 异步操作的重要作用

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

网络请求的本质特性：

// ❌ 错误方式 - 同步思维
const response = this.helpers.httpRequest({ url: 'https://api.example.com' });
console.log(response); // 这里会得到Promise对象，不是实际数据

// ✅ 正确方式 - 异步处理
const response = await this.helpers.httpRequest({ url: 'https://api.example.com' });
console.log(response); // 这里得到实际的API响应数据