在 n8n 的世界里，IF 节点就像一把瑞士军刀，简单、直接，能解决 80% 的分支判断问题。但在 N8N 大学接触的大量实战案例中，我们发现：当业务逻辑涉及数组遍历、多层嵌套判断或复杂的字符串操作时，IF 节点往往会把你的画布变成“意大利面条”，既难维护又难调试。
这时候，你需要的是 Function 节点。它不是简单的计算器，而是你在 n8n 里的“后端大脑”。今天，笔者就带大家深入 Function 节点的内核，用 JavaScript 代码实现那些 IF 节点望尘莫及的复杂逻辑。
为什么 IF 节点在复杂逻辑面前显得笨拙？
举个真实的例子：假设你有一个电商订单流，需要判断“用户是否为 VIP”且“订单金额大于 1000”或“用户注册时间超过 2 年”且“购买了特定类目”。如果用 IF 节点，你需要拖拽至少 3 个 IF 节点，用 AND/OR 连接，画布会变得非常臃肿。
更糟糕的是，如果你需要处理的是一个包含 10 个产品的 JSON 数组，想筛选出所有“库存不足且价格高于 50”的产品，IF 节点根本无法直接处理数组。你必须先用 Split Out 拆分，再逐个判断，效率极低。
Function 节点允许你在 JavaScript 环境中直接操作数据流。它不仅是逻辑判断，更是数据的重塑与清洗。
Function 节点核心实战：从简单判断到数组魔法
在使用 Function 节点前，请确保你的 n8n 实例已开启 Function 节点（默认开启）。Function 节点默认接收上一个节点传递的 JSON 数据，并通过 items 变量访问。
场景一：多条件逻辑判断（替代多层 IF）
我们继续上面的电商例子。在 Function 节点中，我们可以用一行 `if` 语句包裹多个条件，或者直接返回布尔值。
// 伪代码示例：在 Function 节点中编写
for (const item of items) {
const isVip = item.json.user_level === 'VIP';
const isHighValue = item.json.order_amount > 1000;
const isOldUser = item.json.register_days > 730;
// 复杂的与或逻辑
if ((isVip && isHighValue) || isOldUser) {
item.json.pass_check = true;
} else {
item.json.pass_check = false;
}
}
return items;这段代码不仅逻辑清晰，而且比拖拽多个 IF 节点更容易维护。你可以直接在代码里调整阈值，而不用重新连线。
场景二：数组遍历与过滤（IF 节点的盲区）
这是 Function 节点最硬核的能力。假设输入数据是一个包含产品列表的数组，我们需要找出所有需要补货的商品。
// 假设输入结构：items[0].json.products = [{name: 'A', stock: 0}, {name: 'B', stock: 10}]
const results = [];
for (const item of items) {
const products = item.json.products;
// 使用数组的 filter 方法
const lowStockItems = products.filter(p => p.stock 0) {
results.push({
json: {
original_order_id: item.json.id,
need_restock_items: lowStockItems
}
});
}
}
return results;通过这段代码，我们把原本杂乱的数组整理成了清晰的“待补货清单”。如果用 IF 节点，这几乎是一个不可能的任务。
进阶技巧：操作数据流与错误处理
Function 节点不仅仅是写逻辑，它还能帮你清洗数据。N8N 大学在处理 API 响应时，经常会遇到字段名不规范的情况。
数据重塑（Mapping）
你可以利用 JavaScript 的对象解构，在 Function 节点中瞬间完成字段重命名。
return items.map(item => {
return {
json: {
userId: item.json.user_id, // 转换下划线为驼峰
fullName: `${item.json.firstName} ${item.json.lastName}`,
timestamp: new Date().toISOString()
}
};
});安全的错误处理
在 IF 节点中，如果数据缺失，分支可能会走错。但在 Function 节点中，我们可以主动捕获异常，防止整个 Workflow 报错中断。
try {
// 危险的操作，比如解析 JSON 字符串
const data = JSON.parse(items[0].json.raw_data);
return [{ json: data }];
} catch (error) {
// 即使出错，我们也返回一个结构化的错误信息，而不是让 n8n 崩溃
return [{
json: {
error: true,
message: error.message
}
}];
}这种“防御性编程”思维，是让自动化流程稳定运行 7x24 小时的关键。
避坑指南：Function 节点的常见陷阱
虽然 Function 节点很强大，但新手容易踩坑。以下是 N8N 大学总结的 2 个高频问题：
1. 忘记返回 items
Function 节点必须显式返回 `items` 或修改后的 `items` 数组。如果你只写了逻辑但没有 `return items;`，后续节点将收不到任何数据，导致流程莫名中断。
2. 混淆同步与异步
n8n 的 Function 节点默认是同步执行的。如果你在 Function 节点里写入了大量的 HTTP 请求（虽然不推荐，应该用 HTTP Request 节点），会导致整个节点阻塞。对于耗时操作，请考虑使用 Function Item 节点或拆分流程。
FAQ：关于 n8n Function 节点的常见问题
Q1：Function 节点和 Function Item 节点有什么区别？
Function 节点：处理整个 `items` 数组。你可以合并、拆分或过滤数据，输出数量可以和输入不同。
Function Item 节点：一次只处理一条数据（item）。代码写在 `return item.json;` 中，性能更好，但不能改变数据结构。
Q2：Function 节点支持 ES6 语法吗？
是的。n8n 基于 Node.js 运行环境，完全支持 ES6+ 特性，如箭头函数、`const/let`、模板字符串以及 `async/await`（需在 Function 节点设置中开启异步模式，或使用 Async Function）。
Q3：如何在 Function 节点中引入第三方库？
默认情况下，Function 节点只提供原生 JavaScript API。如果你需要使用 lodash、moment 等库，通常需要在 n8n 的宿主机上通过 npm 全局安装，或者在 Docker 容器中挂载卷。对于简单需求，建议尽量使用原生 JS 以减少依赖。
总结与资源
IF 节点适合简单的二元选择，而 Function 节点则是处理复杂业务逻辑、数据清洗和数学计算的终极武器。掌握它，意味着你从 n8n 的“使用者”进阶为了“开发者”。
在 N8N 大学，我们建议你在画布中大胆尝试 Function 节点，但务必做好错误捕获。记住，强大的代码意味着更大的责任。
相关资源推荐：
- n8n 官方文档 - Function 节点 API 参考
- MDN JavaScript 教程（复习基础语法）
- N8N 大学社区 - 查看更多实战 Workflow 模板
