3. Node-RED核心概念

在开始构建物联网仪表盘之前，必须透彻理解 Node-RED 的五大核心概念。它们是整个编程模型的基石，决定了你如何组织逻辑、传递数据以及管理状态。本章将逐一拆解这些概念，并通过对比表格和结构图帮助你建立清晰的认知。

3.1 核心概念总览

Node-RED 是一种流式编程工具。你可以把它想象成一个电子电路：节点是元器件，连线是导线，流是电路板，消息是电流，而上下文则是电路中的储能元件或寄存器。下表快速对比了这五个概念的角色：

3.2 流 (Flow) —— 逻辑容器

流是 Node-RED 编辑器顶部的一个标签页。每个标签页代表一个独立的流，拥有自己的画布空间。流的核心价值在于逻辑分组：你可以将温度采集逻辑放在“传感器流”，将仪表盘显示逻辑放在“仪表盘流”，两者通过上下文或消息桥接。

• 默认流： 新建项目时自动创建名为“Flow 1”的标签页。
• 命名规范： 双击标签页可重命名，建议使用有业务含义的名称，如 设备数据采集、告警处理。
• 跨流通信： 流之间不能直接连线，必须通过 Context 或 Link 节点 实现数据交换。

3.3 节点 (Node) —— 功能单元

节点是 Node-RED 中最基本的执行单元。每个节点都遵循 输入 → 处理 → 输出 的模型。根据功能，节点可分为三大类：

3.4 连线 (Wire) —— 数据通路

连线是节点之间的有向连接，用鼠标从一个节点的输出端口拖拽到另一个节点的输入端口即可创建。连线决定了消息的传递路径。

• 单输出 → 多输入： 一个输出端口可以连接多个输入端口，消息会广播到所有下游节点。
• 多输出 → 单输入： 多个输出端口可以连接到同一个输入端口，消息会合并进入该节点。
• 删除连线： 选中连线后按 Delete 键，或右键选择“删除”。
• 连线颜色： 默认灰色；当消息通过时，连线会短暂变为绿色，表示有数据流动。

3.5 消息 (Msg) 对象 —— 数据载体

消息对象是 Node-RED 中唯一的数据交换格式。它是一个标准的 JavaScript 对象，在节点之间流动。最核心的属性是 msg.payload，它承载了实际的数据内容。

一个典型的消息对象结构如下：

{
  "_msgid": "a1b2c3d4",      // 自动生成的唯一消息ID
  "topic": "sensor/temp",    // 主题，常用于 MQTT 或路由
  "payload": {               // 核心数据负载
    "temperature": 25.6,
    "humidity": 68.2,
    "unit": "celsius"
  },
  "req": null,               // HTTP 请求对象（仅 HTTP 节点使用）
  "res": null                // HTTP 响应对象（仅 HTTP 节点使用）
}

3.6 上下文 (Context) —— 状态存储

上下文提供了跨节点、跨流、跨部署的数据持久化能力。它分为三个作用域：

在 function 节点中读写上下文的示例：

// 读取全局上下文中的设备列表
var devices = global.get('deviceList') || [];

// 添加新设备
devices.push({ id: 'sensor-01', value: msg.payload });

// 写回流级上下文
flow.set('latestDevice', devices[devices.length - 1]);

// 返回消息
return msg;

3.7 核心概念关系图

下图展示了五个核心概念在 Node-RED 运行时中的协作关系：

3.8 消息在连线中的流动过程

为了让你更直观地理解消息如何穿越节点和连线，下图展示了一个典型的“温度采集→处理→显示”流程：

3.9 最佳实践与避坑指南