n8n多语言扩展：Code节点Python与JS选择指南（附：多节点数据聚合与JSON构造）

作者： Dr.n8n 更新时间：2025-12-19 04:00:41 分类：n8n教程

当Code节点报错时，你选Python还是JS？别让语言选择拖垮你的自动化流程

上周帮一家跨境电商客户调试他们的订单自动分发系统时，他们卡在一个奇怪的问题上：明明Code节点逻辑写对了，但下游节点就是拿不到构造好的JSON数据。最后发现，问题根源竟然是——他们在Python里用json.dumps()输出对象，却忘了在n8n里设置returnItems结构。这种“以为成功实则失败”的情况，在多语言Code节点中太常见了。

Dr. n8n 提醒：n8n的Code节点不是普通脚本编辑器，它是“工作流中的数据转换枢纽”。无论你用JS还是Python，最终必须返回符合n8n规范的items[]数组结构，否则就像快递打包好了却不贴运单——系统根本不知道往哪送。

JS vs Python：不是谁更强大，而是谁更适合当前场景

很多初学者问我：“Dr. n8n，我该学JS还是Python来写Code节点？”我的回答是：看你要处理什么“食材”。

选JavaScript（Node.js）：如果你的数据来自Webhook、HTTP Request、或需要频繁操作JSON对象，JS是“原生主场选手”。n8n底层就是Node.js，JS节点零转换开销，调试反馈快如闪电。
选Python：当你需要调用机器学习库（如sklearn）、处理复杂文本分析（正则+NLTK）、或对接企业遗留系统（如SAP接口），Python生态就是你的瑞士军刀。

举个真实案例：我曾为某教育平台搭建“学生行为自动打标系统”。前端传来的JSON结构混乱，字段名大小写混杂。用JS的Object.keys().map()三行搞定标准化；而如果用Python，光是import json, re再遍历dict就得多写十几行——这种时候，语言效率差异立现。

实战教学：三步构造“下游节点能吃的JSON”

无论你选哪种语言，核心目标只有一个：把数据包装成n8n认识的“标准餐盒”——即items数组里的每个对象都包含json属性。以下是通用模板：

// JavaScript 版本
return items.map(item => {
  return {
    json: {
      processed_data: item.json.raw_input.toUpperCase(),
      timestamp: new Date().toISOString()
    }
  };
});

# Python 版本
from datetime import datetime

return [{
    "json": {
        "processed_data": item["json"]["raw_input"].upper(),
        "timestamp": datetime.utcnow().isoformat()
    }
} for item in items]

注意两个细节：

Python版必须显式return一个列表（哪怕只有一条数据），JS版虽然可单对象但强烈建议保持数组习惯。
所有自定义字段必须塞进json对象内——这是n8n的“数据保鲜膜”，撕掉它下游节点会直接报错“找不到字段”。

高阶技巧：聚合多个节点数据，像拼乐高一样构造复杂JSON

真正的痛点往往出现在“多源数据融合”场景。比如：从CRM拿客户信息 + 从ERP拿订单历史 + 从客服系统拿最近对话记录 → 合并成一个“客户全景视图”JSON。

解决方案：用Merge节点预合并 + Code节点深加工。假设Merge后数据结构如下：

字段来源	字段路径
CRM节点	`json.crm.name`
ERP节点	`json.erp.last_order_date`
客服节点	`json.support.latest_ticket`

在Code节点中这样聚合（以JS为例）：

return items.map(item => {
  const crm = item.json.crm || {};
  const erp = item.json.erp || {};
  const support = item.json.support || {};

  return {
    json: {
      customer_profile: {
        name: crm.name,
        vip_level: calculateVip(erp.total_spent), // 自定义函数
        last_contact: support.latest_ticket?.created_at,
        risk_flag: (new Date() - new Date(erp.last_order_date)) > 30*86400000
      }
    }
  };
});

function calculateVip(total) {
  return total > 10000 ? 'Gold' : total > 5000 ? 'Silver' : 'Bronze';
}

这里的关键是：防御性编程。用|| {}避免字段缺失报错，用?. 安全访问嵌套属性——这些在Python里对应.get()和try-except。