别让 Code 节点成为你的自动化拦路虎
在 N8N 大学的社区里，我经常看到一种两极分化：有人觉得 Code 节点是神器，能处理一切逻辑；也有人看到它就头大，甚至宁愿用 5 个 IF 节点硬凑逻辑。
说实话，笔者刚接触 n8n 时，也曾对 Code 节点心存敬畏。毕竟它需要写 JavaScript，这听起来像是程序员的专属领域。但随着实战经验的积累，我发现 Code 节点其实是 n8n 自动化流程的“大脑”。一旦掌握，你的工作流效率将提升 10 倍不止。
今天，这篇指南不讲枯燥的语法教科书。我们将从实战出发，结合社区高频踩坑点，教你如何像写“大白话”一样驾驭 Code 节点。
Code 节点的核心心法：数据流转
很多新手写 Code 节点报错，根本原因没搞懂 n8n 的数据结构。在 n8n 里，数据不是乱糟糟的一团，而是以 Item（条目）为单位的数组。
核心原则： Code 节点的输入是什么，输出就是什么。
如果你在 Code 节点里直接返回 return [{json: {name: 'test'}}]，那么下个节点收到的数据结构就变了。最稳妥的做法是修改当前的 Item，而不是重新创建。
1. 基础写法：修改现有数据
这是最常用的场景。比如你想把两个字段合并，或者格式化时间。
// 错误写法（直接覆盖输入）
return [{json: {result: "done"}}];
// 正确写法（修改当前 Item）
for (const item of items) {
item.json.new_field = "我是新字段";
}
return items;
注意这里的 items 变量，它是 n8n 注入的全局变量，包含了所有输入数据。
2. 进阶写法：过滤与转换
有时我们需要根据条件筛选数据，或者把列表扁平化。
// 筛选金额大于 100 的订单
const filteredItems = items.filter(item => {
return item.json.amount > 100;
});
// 返回过滤后的结果
return filteredItems;
这种写法在处理 API 批量返回的数据时非常有用，能帮你快速清洗数据。
实战场景：如何处理复杂的 JSON 结构
现实世界的数据往往很脏。比如 API 返回的嵌套对象，或者你需要从一个数组里提取特定值。
场景一：提取嵌套字段
假设 API 返回 { "user": { "profile": { "email": "test@example.com" } } }，你想把 email 提升到顶层。
for (const item of items) {
// 使用可选链操作符防止报错
item.json.email = item.json.user?.profile?.email;
// 删除原结构（可选）
delete item.json.user;
}
return items;
**避坑点：** 这里必须用 ?.。如果某条数据没有 user 字段，直接写 item.json.user.profile.email 会导致整个工作流报错停止。
场景二：生成随机 ID 或时间戳
虽然 n8n 有专门的工具节点，但在 Code 节点里处理更灵活。
for (const item of items) {
item.json.random_id = Math.random().toString(36).substring(7);
item.json.timestamp = new Date().toISOString();
}
return items;
这里要注意时区问题。n8n 的服务器时间通常是 UTC，如果你需要本地时间，需要手动转换。
社区文档与实战避坑指南
Code 节点虽然强大，但坑也不少。以下是 N8N 大学社区总结的高频问题：
坑 1：浏览器环境 vs Node.js 环境
很多人在 Code 节点里写 require('axios') 或 require('moment')，结果报错。
真相： n8n 的 Code 节点运行在 JavaScript 沙箱中，它是纯 JS 环境（基于 Node.js），但默认没有安装第三方 npm 包。
解决方案：
- 使用原生 JS： 处理日期用
new Date()，处理 HTTP 请求用HTTP Request节点（这是 n8n 的理念，各司其职）。 - 如果必须用库： 你需要在 n8n 的后台（Docker 环境）进入容器手动
npm install，但这不推荐，因为重启容器后可能会丢失（除非挂载了卷）。
坑 2：循环处理的性能陷阱
有些同学在 Code 节点里写复杂的双重循环，处理上千条数据时，n8n 界面会卡死。
建议： 尽量避免在 Code 节点做 O(n²) 的操作。如果数据量大，考虑分批处理，或者使用 Split Out 节点拆分后再处理。
坑 3：返回值类型错误
Code 节点必须返回 items 或者 [{json: {...}}] 格式。
如果你不小心返回了 return true 或 return "string"，下一个节点会报错。请务必检查 return 语句。
Code 节点与 Function 节点的区别
在 n8n 中，你可能会看到 Code 和 Function 两个节点。虽然它们看起来很像，但有细微差别：
| 节点名称 | 适用场景 | 推荐度 |
|---|---|---|
| Code | 简单的数据处理、字段映射、JS 逻辑判断 | ⭐⭐⭐⭐⭐ (首选) |
| Function | 需要引入外部模块、复杂计算（已逐渐被 Code 替代） | ⭐⭐ (老版本遗留) |
笔者建议：除非你的 n8n 版本非常老，否则一律使用 Code 节点。它的界面更友好，且官方维护更积极。
FAQ 问答
Q1: Code 节点支持 Python 吗？
目前 n8n 的 Code 节点主要支持 JavaScript/TypeScript。虽然 n8n 支持 Python 节点，但那是独立的节点类型，不是 Code 节点。如果你是 Python 开发者，可以尝试使用 Python 节点，但生态不如 JS 节点丰富。
Q2: 如何在 Code 节点中调试代码？
最简单的方法是使用 console.log(items)。运行工作流后，点击 Code 节点，查看右侧的 Input 面板，虽然你看不到 console 的输出（除非看后台日志），但你可以通过在节点里设置 item.json.debug = ... 来可视化数据变化。
Q3: Code 节点里的数据能跨节点保留吗？
不能。每个节点都是独立的。如果你需要在多个节点间共享变量，可以使用 Set 节点设置全局变量，或者利用 n8n 的 Workflow 变量（如果配置了环境变量）。但在 Code 节点内部，变量只在当前执行流中有效。
总结与资源
Code 节点是 n8n 从“好用”进阶到“精通”的必修课。它不需要你成为 JS 大牛，但需要你理解 n8n 的数据流转逻辑。
核心建议： 多用原生 JS，少依赖第三方库；处理数据前先“防御性编程”，防止字段缺失报错。
如果你想深入学习，欢迎访问 N8N大学 (n8ndx.com)，我们整理了更多实战案例和社区插件。记住，自动化不是为了炫技，而是为了解放双手。
