在 n8n 的世界里，如果你只用拖拽现成的节点，那就像开自动挡的车——方便，但永远无法征服崎岖的越野路段。真正的自动化高手，手里都握着一把瑞士军刀：**Code 节点**。

很多 N8N大学 的学员在面对复杂的 API 返回数据、需要自定义处理逻辑，或是想动态生成特定格式时，往往会被卡住。今天，笔者就带你拆解 Code 节点的实战心法，从 JSON 解析到动态生成，让你真正掌握 n8n 的“灵魂”。

为什么你需要掌握 Code 节点？

Code 节点本质上是一个嵌入在 n8n 工作流中的 JavaScript 执行环境。它允许你编写原生 JS 代码来处理数据。这意味着，只要你能写 JS，你就能在 n8n 里实现任何逻辑，不再受限于官方节点的功能边界。

它的核心价值在于：灵活性与性能。相比于串联多个 Set、IF、Switch 节点来处理复杂逻辑，一段简洁的 JS 代码往往能以一敌十，不仅流程图更清晰，执行效率也更高。

实战心法一：JSON 数据的深度解析与重塑

这是 Code 节点最基础也是最常用的场景。假设你调用了一个 API，返回了一个嵌套很深的 JSON 对象，而你只需要其中的几个字段，并且需要重新组装成 n8n 喜欢的“扁平化”结构。

场景案例

假设 API 返回如下数据，我们需要提取每个用户的 ID 和名字，并在名字前加上前缀：

{
  "data": {
    "users": [
      { "id": 1, "info": { "name": "Alice" } },
      { "id": 2, "info": { "name": "Bob" } }
    ]
  }
}

Code 节点配置

在 Code 节点中，我们使用 Javascript (Node.js) 模式。输入代码如下：

const newItems = [];
for (const item of items) {
  const users = item.json.data.users;
  for (const user of users) {
    newItems.push({
      json: {
        userId: user.id,
        fullName: `User: ${user.info.name}`
      }
    });
  }
}
return newItems;

这里的关键在于，n8n 的 Code 节点输出必须是一个数组，且每个元素包含 json 属性。通过双重循环，我们成功将嵌套结构“拍平”并进行了动态字符串拼接。

实战心法二：动态生成逻辑与数据组装

有时候，你需要根据输入数据动态生成一段文本、一封邮件，甚至是一段 SQL 语句。这时候，字符串模板和数组操作是你的利器。

批量生成 SQL 语句

假设你有一个包含多条数据的数组，需要批量生成 Insert 语句。在 Code 节点中，我们可以这样做：

const sqlStatements = [];
for (const item of items) {
  const { name, age, city } = item.json;
  // 注意：生产环境务必处理 SQL 注入，这里仅做演示
  const sql = `INSERT INTO users (name, age, city) VALUES ('${name}', ${age}, '${city}');`;
  sqlStatements.push({ json: { sql } });
}
return sqlStatements;

通过这个简单的循环，你将一条输入数据变成了多条输出数据，每条输出数据都携带一条独立的 SQL 语句。这在配合 MySQL 或 Postgres 节点的“从输入行获取数据”模式时非常高效。

实战心法三：处理报错与异常捕获

初级用户在使用 Code 节点时，最常遇到的问题就是数据格式不匹配导致工作流报错。为了避免整个流程因为一条脏数据而崩溃，我们需要加入防御性编程。

安全的字段提取

不要直接访问深层属性，除非你确定它存在：

try {
  const safeData = items.map(item => {
    return {
      json: {
        // 使用可选链操作符 ?. 防止报错
        id: item.json?.data?.id || 'unknown',
        timestamp: item.json?.timestamp || new Date().toISOString()
      }
    };
  });
  return safeData;
} catch (error) {
  // 即使出错，也要返回结构化的错误信息，而不是抛出未捕获的异常
  return [{ json: { error: error.message } }];
}

这段代码确保了即使输入数据结构缺失，工作流也能继续运行，并输出一个带有 error 字段的标记数据，方便后续通过 IF 节点进行分支处理。

避坑指南：新手常犯的错误

在 N8N大学 的教学过程中，笔者发现以下几个坑是必经之路：

• 输出格式错误： Code 节点必须返回一个数组。如果你只返回了 { json: {...} } 或者直接返回了对象，下游节点将无法读取数据。
• 误用全局变量： 在 Code 节点中，不要尝试通过 $() 或 items 变量以外的途径去访问前序节点的“私有”上下文。始终通过 items 数组来处理输入。
• 性能瓶颈： 如果数据量达到数万条，尽量避免在 Code 节点中进行复杂的同步计算，这会阻塞 n8n 的执行。此时应考虑分页或使用外部脚本。

FAQ：关于 Code 节点的常见疑问

1. Code 节点支持 Python 或其他语言吗？

目前 n8n 官方的 Code 节点主要支持 JavaScript (Node.js)。不过，你可以通过 SSH 节点或 HTTP Request 节点调用外部 API（例如 Python 编写的 microservice）来实现多语言混合编程。

2. 如何在 Code 节点中调试代码？

n8n 提供了一个非常实用的功能：点击 Code 节点后，查看 “Schema” 或 “Output”。对于复杂逻辑，建议先在本地 VS Code 中编写并通过测试，再粘贴到 n8n 中。也可以使用 console.log()，日志会显示在 n8n 的执行日志中。

3. Code 节点会泄露敏感数据吗？

不会。Code 节点的代码是运行在 n8n 服务端的。但是，请注意不要将硬编码的 API Key 或密码直接写在 Code 节点中。正确做法是使用 n8n 的 Credentials（凭证） 系统，或者通过环境变量传入。

总结与资源

掌握 Code 节点，是 n8n 从“好用”进阶到“强大”的关键一步。它打破了节点功能的限制，让你能处理任何数据结构，实现任意复杂的业务逻辑。

记住，Code 节点不是为了炫技，而是为了解决问题。保持代码简洁、健壮，才是自动化的心法真谛。如果你在实战中遇到了棘手的 JSON 解析问题，欢迎回到 N8N大学 (n8ndx.com)，这里总有一篇实战笔记能帮到你。