别再只把 Code 节点当“计算器”用了
在 N8N 大学的社群里，我见过太多同学把 n8n 玩成了“连连看”。拖拽节点，连线，配置 API，这没错。但当业务逻辑稍微复杂一点，比如需要清洗数据、处理日期格式、或者进行复杂的条件判断时，很多人就开始头疼了。
这就是为什么你需要掌握 Code 节点 (Code Node)。
很多新手甚至中级用户，对 Code 节点有误解，觉得“我是来搞自动化的，不是来写代码的”。这种想法大错特错。在企业级自动化实战中，Code 节点是 n8n 的“瑞士军刀”，是连接简单逻辑与复杂业务的桥梁。今天，笔者就带你深入 Code 节点的高级编程，让你的自动化流程从“能用”进化到“好用”。
为什么企业级自动化离不开 Code 节点？
在 n8n 的世界里，数据是以 JSON 格式在节点间流动的。虽然 n8n 提供了 Set、IF、Switch 等节点来处理数据，但面对以下场景，原生节点往往显得笨重且代码量庞大：
- 复杂数据清洗： 需要对数组进行深层嵌套遍历、过滤或映射。
- 自定义加密/解密： 处理 MD5、SHA256 或自定义的 Base64 编码逻辑。
- 动态参数生成： 根据运行时的数据动态生成 HTTP 请求的 Header 或 Body。
- 日期与时间的复杂计算： 超出原生节点支持的时区转换或时间间隔计算。
Code 节点就是为了解决这些“硬骨头”而生的。它允许你直接操作 JSON 数据流，执行 JavaScript 代码，从而实现无限的逻辑可能性。
Code 节点核心实战：从入门到精通
在开始之前，请确保你的 n8n 版本是最新的。Code 节点在不同版本中（尤其是从 n8n 1.0 更新后）的 API 有些许变化，本文基于最新的 1.0+ 版本进行讲解。
1. 理解 Code 节点的数据进出机制
在 Code 节点中，输入数据通过 $input 对象访问，输出数据则通过 $output 对象返回。这是最基础也是最重要的概念。
实战场景： 你从 HTTP 请求节点获取了一堆用户数据，但只需要用户的 ID 和邮箱，且邮箱要转为小写。
// 在 Code 节点的 JavaScript 编辑器中
const users = $input.all(); // 获取所有输入项
// 使用 map 处理数据
const cleanedUsers = users.map(item => ({
json: {
userId: item.json.id,
email: item.json.email.toLowerCase(), // 核心逻辑：转小写
timestamp: new Date().toISOString()
}
}));
return cleanedUsers;避坑指南： n8n 的 Code 节点处理的是“Item”列表。默认情况下，你需要返回一个数组。如果你想返回单个对象，可以使用 $output.item = { ... }，但最稳妥的方式始终是返回一个数组结构。
2. 高级数据处理：过滤与聚合
在企业级场景中，我们经常需要对列表进行“过滤”或“聚合”操作。比如，从销售记录中筛选出金额大于 1000 的订单，并计算总金额。
使用原生节点可能需要多个 Filter 和 Sum 节点串联，而 Code 节点一行代码即可搞定：
const salesData = $input.all();
// 过滤并计算
const highValueOrders = salesData.filter(item => item.json.amount > 1000);
// 如果你需要将结果传递给下一个节点，必须返回数组
return highValueOrders;如果你需要聚合数据（例如计算总和），不要忘记在最后返回一个包含聚合结果的数组：
const total = salesData.reduce((sum, item) => sum + (item.json.amount || 0), 0);
// 返回一个包含总金额的新对象
return [{ json: { totalAmount: total } }];笔者提示： 这种写法在处理大数据流时非常高效。但要注意，如果数据量极大（例如几万条），直接在内存中处理可能会导致 n8n worker 崩溃。此时应考虑分页或流式处理。
3. 调用外部库与原生模块
这是 Code 节点最强大的功能之一。n8n 的 Code 节点基于 Node.js 环境，这意味着你可以引入大量的 npm 包来辅助计算。
假设你需要处理复杂的日期计算，原生的 JavaScript Date 对象很难处理“下个月的最后一个工作日”这种需求。此时，引入 dayjs 是最佳选择。
操作步骤：
- 在 Code 节点设置中，找到 Modules 选项（或者在代码顶部通过特定语法引入）。
- 添加
dayjs（前提是你的 n8n 环境已安装该包，或者使用require动态加载）。
const dayjs = require('dayjs');
const inputDate = $input.first().json.date;
const nextMonthLastDay = dayjs(inputDate).add(1, 'month').endOf('month').format('YYYY-MM-DD');
return [{
json: {
resultDate: nextMonthLastDay
}
}];注意： 在 n8n Cloud 或标准 Docker 镜像中，部分常用库可能预装，但自定义库通常需要在 Dockerfile 中额外安装，或者使用 n8n 的“自定义二进制文件包”功能。对于企业级私有部署，建议在构建镜像时统一管理依赖。
企业级实战中的常见陷阱与解决方案
在 N8N 大学的案例库中，90% 的 Code 节点报错都源于以下三个原因：
1. 异步处理不当
虽然 n8n 1.0+ 简化了异步处理，但在 Code 节点中直接使用 async/await 时，必须确保返回的是一个 Promise 或明确的数据结构。
错误示范：
// 忘记 return 或者没有正确处理 Promise
async function getData() {
// ... 复杂逻辑
}
getData(); // 这样不会报错，但下一个节点收不到数据！正确示范：
async function getData() {
const data = await fetchSomething();
return data;
}
return getData();2. 数据类型转换错误
n8n 的 JSON 数据流对类型非常敏感。如果你在 Code 节点中返回了 undefined 或者 null，可能会导致下游节点（特别是 HTTP Request）解析失败。
防御性编程建议：
const rawValue = $input.first().json.value;
const safeValue = rawValue ? Number(rawValue) : 0;
return [{ json: { safeValue } }];3. 误删输入项
很多同学在修改数据时，直接覆盖了 json 对象，导致丢失了上游传来的关键元数据（如 itemId）。建议使用展开运算符保留原数据。
const original = $input.first().json;
return [{
json: {
...original, // 保留所有原始字段
processed: true // 添加新字段
}
}];FAQ：关于 Code 节点的常见疑问
Q1: 我不懂 JavaScript，还能用 n8n 做复杂自动化吗？
A: 可以，但有天花板。对于简单的逻辑，原生节点足够。但一旦涉及企业级复杂流程，学习基础的 JavaScript（特别是数组操作 map/filter/reduce）是必须的。建议先从简单的字符串拼接开始练习。
Q2: Code 节点执行速度慢怎么办？
A: 首先检查代码逻辑是否过于复杂（如多重嵌套循环）。其次，如果是处理大量数据，尝试分批处理，不要一次性把几万条数据塞进 Code 节点。最后，确保你的 n8n 实例有足够的内存（RAM）。
Q3: 如何在 Code 节点中调试代码？
A: n8n 的界面目前没有强大的断点调试功能。最实用的调试方法是使用 console.log() 输出变量值，然后在 n8n 的 Execution Log（执行日志）中查看输出。或者，先用一个简单的 Set 节点把数据存下来，再逐步处理。
总结与资源
Code 节点是 n8n 自动化能力的“核武器”。它将低代码的便捷性与原生代码的灵活性完美结合。掌握它，你就能突破模板的限制，真正实现“业务逻辑定义自动化”。
在 N8N 大学，我们始终相信：工具是死的，思路是活的。不要被节点限制住想象力，Code 节点就是你打破次元壁的那把钥匙。
延伸阅读与资源：
- N8N 大学官网：更多硬核实战教程。
- n8n 官方文档：查阅 Code 节点的 API 参考。
- Node.js 官方文档：深入学习 JavaScript 内置模块。
