作为 N8N大学 的首席主编，笔者在社区里见过太多新手在写 JavaScript 时一头雾水：明明都是写代码，为什么 n8n 里还要搞两个节点——Function 和 Code？选错了不仅效率低，还容易踩坑。

今天，我们就来硬核拆解这两个节点的区别。这不是一篇枯燥的文档翻译，而是基于 8 年实战经验的“选型指南”，帮你彻底搞懂什么时候该用 Function，什么时候该上 Code。

核心定义：Function 节点到底是什么？

很多初学者容易被名字误导。在 n8n 的语境里，Function 节点 并不是让你写一段复杂的函数体，而是提供了一个“纯 JavaScript 环境”。

简单来说，当你在 Function 节点写代码时，你是在处理当前输入数据的快照。它不依赖外部库，执行速度极快，且完全在 Node.js 的原生环境中运行。

笔者用大白话总结：**Function 是 n8n 的“瑞士军刀”**。它适合做数据清洗、格式转换、简单的逻辑判断。如果你只是想把时间戳转成日期，或者把字符串拼接一下，Function 是最轻量的选择。

Code 节点：功能更强大的代码编辑器

如果你用过旧版本的 n8n，你可能对 Code 节点更熟悉。在新版 n8n 中，Code 节点通常被标记为 Legacy Code（旧版代码节点），或者在高级设置中可见。

与 Function 节点不同，Code 节点更像是一个完整的 JavaScript 执行沙箱。它允许你编写更复杂的逻辑，甚至可以引入一些特定的上下文操作。不过，随着 n8n 的迭代，Function 节点逐渐成为主流，Code 节点更多是为了兼容旧工作流。

不过，我们必须承认，在某些特定的复杂逻辑处理上，Code 节点依然有它的历史地位。但如果你是新起炉灶，笔者建议优先考虑 Function。

深度解析：Function vs Code 核心对比

为了更直观地展示区别，笔者整理了以下对比表。这是基于 n8n 最新版（1.0+）的特性分析的。

实战场景：写 JavaScript 时到底选哪个？

光看理论不够，我们直接上实战场景。以下三个案例，能帮你快速做出决定。

场景一：简单的数据格式转换

假设你从 HTTP Request 获取了一串 JSON，需要把 created_at 字段从 Unix 时间戳转成标准日期字符串。

选择：Function 节点

原因：这是纯粹的 JavaScript 操作，不需要任何外部依赖，Function 节点的轻量级特性完美匹配。

场景二：复杂的数组遍历与聚合

你需要遍历一个包含 1000 条数据的数组，进行复杂的数学计算，并生成一个新的对象结构。

选择：Function 节点

原因：虽然数据量大，但只要逻辑在原生 JS 能力范围内，Function 节点的性能优于 Code 节点。如果计算量极大，建议在 Function 节点中优化算法，而不是换节点。

场景三：需要调用外部库（如 Lodash）

这是很多人的误区。如果你在 n8n 里想直接 require('lodash')，Function 节点通常会报错，因为它运行在受限的沙箱里。

选择：npm 包节点 或 HTTP Request 节点

注意：这里既不是 Function 也不是 Code。N8N 官方不建议在代码节点里引入大量第三方包。如果必须用复杂库，建议通过 HTTP Request 调用外部 API，或者使用专门的“npm 包”节点（如果你的 n8n 环境支持自定义安装）。

避坑指南：Function 节点的常见误区

在 N8N大学 的社区里，关于 Function 节点的报错咨询每天都有。以下是两个最典型的坑：

1. 忘记 Return

在 Function 节点中，你必须返回数据。如果你的代码没有 return items;，流程就会中断，且没有任何报错提示。

笔者经验：永远在代码最后加上 return items;，或者根据业务逻辑返回处理后的数据数组。

2. 试图操作 DOM

新手常误以为 n8n 的代码节点像浏览器控制台一样。实际上，n8n 运行在服务器端（Node.js），没有 document 或 window 对象。如果你试图操作 DOM，代码会直接崩溃。

为什么 n8n 的代码能力是核心竞争力？

相比于 Zapier 等封闭式 SaaS，n8n 最大的优势在于开源和灵活性。Function 节点的存在，意味着你不需要被预设的节点限制。

你可以把 n8n 想象成一个乐高底板，而 Function 节点就是那些可以随意变形的积木。无论你的业务逻辑多刁钻，只要你会 JS，就能在 n8n 里实现自动化。

这也是 N8N大学 一直倡导的理念：**代码是自动化的最后一道防线**。当可视化节点无法满足需求时，Function 节点就是你的救生圈。

FAQ 常见问题解答

Q1: 在 Function 节点里写 async/await 会报错吗？
A: 不会。Function 节点完全支持 ES6+ 语法，包括 async/await。但要注意，如果你的逻辑是异步的，确保正确处理 Promise。

Q2: Function 节点和 Set 节点有什么区别？
A: Set 节点是“可视化”的字段设置，适合简单的赋值。Function 节点是“代码式”的字段设置，适合需要计算或逻辑判断的复杂赋值。

Q3: 旧版 Code 节点的数据怎么迁移到 Function？
A: 逻辑通常是相通的。旧版 Code 节点通常处理的是 json 对象，而新版 Function 节点处理的是 items 数组。你需要将操作单个对象的逻辑，改为遍历数组的逻辑。

总结与资源

简单来说，Function 节点是 n8n 中编写 JavaScript 的首选。它更轻量、更现代、性能更好。除非你维护的是非常古老的 n8n 工作流，否则请拥抱 Function 节点。

如果你想深入学习 n8n 的高级用法，欢迎访问 N8N大学。我们不仅提供教程，更提供实战中的避坑经验。记住，自动化不是目的，而是让你从重复劳动中解脱出来的手段。