2. Node-RED开发环境搭建
搭建Node-RED开发环境是进入物联网数据采集实战的第一步。Node-RED基于Node.js运行，因此需要先安装Node.js运行时，再通过其包管理器npm安装Node-RED核心模块，最后启动服务并通过浏览器访问可视化编辑器。
2.1 环境依赖与版本选择
Node-RED对Node.js版本有明确要求，不同版本对应不同的长期支持（LTS）策略。下表列出了当前主流版本的兼容关系：
| Node.js 版本 | Node-RED 兼容版本 | 推荐场景 |
|---|---|---|
| 18.x LTS | 3.x / 4.x | 生产环境首选，稳定且社区支持完善 |
| 20.x LTS | 4.x | 新项目推荐，性能与安全性更优 |
| 22.x LTS | 4.x | 最新长期支持版，适合新部署 |
| 非LTS（如21.x） | 不推荐 | 仅用于临时测试，不建议用于课程项目 |
版本选择建议： 本课程统一使用 Node.js 20.x LTS 搭配 Node-RED 4.x，确保所有示例代码和节点库兼容无误。
2.2 Node.js 安装步骤
Node.js的安装方式因操作系统而异，以下列出Windows、macOS和Linux三种主流平台的安装方法。
2.2.1 Windows 平台
- 访问 nodejs.org，下载 Windows Installer (.msi) 64位版本。
- 双击安装包，勾选 "Automatically install the necessary tools"，其余选项保持默认。
- 安装完成后，打开命令提示符（cmd）或 PowerShell，验证安装：
node --version
npm --version输出示例：
v20.18.0
10.8.22.2.2 macOS 平台
- 推荐使用 Homebrew 安装，打开终端执行：
brew install node@20- 或者从官网下载 macOS Installer (.pkg) 直接安装。
- 验证安装：
node --version
npm --version2.2.3 Linux 平台（Ubuntu/Debian）
- 使用 NodeSource 官方仓库安装：
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs- 验证安装：
node --version
npm --version
常见问题： 如果
npm 版本低于 8.x，请执行 npm install -g npm@latest 升级。低版本 npm 可能导致 Node-RED 安装失败。
2.3 Node-RED 安装与启动
Node.js安装完成后，通过npm全局安装Node-RED。全局安装使node-red命令可在任意目录下使用。
2.3.1 全局安装 Node-RED
npm install -g node-red安装过程会下载核心模块及依赖包，耗时约1-3分钟。安装完成后，终端显示类似信息：
+ node-red@4.0.5
added 456 packages in 35s2.3.2 启动 Node-RED 服务
在终端中直接执行以下命令启动：
node-red启动成功后，终端输出关键信息：
Welcome to Node-RED
===================
28 Nov 10:15:23 - [info] Node-RED version: v4.0.5
28 Nov 10:15:23 - [info] Node.js version: v20.18.0
28 Nov 10:15:23 - [info] Server now running at http://127.0.0.1:1880/
28 Nov 10:15:23 - [info] Starting flows
28 Nov 10:15:23 - [info] Started flows
启动参数说明： 默认端口为 1880。如需修改端口，可使用
node-red -p 1881；如需指定用户目录，使用 node-red -u ~/.node-red-custom。
2.4 浏览器访问 Node-RED 编辑器
Node-RED服务启动后，打开任意现代浏览器（Chrome、Edge、Firefox），在地址栏输入：
http://localhost:1880即可进入Node-RED可视化编辑器界面。编辑器主要分为三个区域：
- 左侧调色板（Palette）： 包含所有可用节点，按功能分组（常用、功能、网络、序列、解析等）。
- 中间工作区（Workspace）： 拖放节点、连接线、编排流程的画布区域。
- 右侧信息/调试面板（Info/Debug）： 显示节点帮助信息、调试输出消息。
2.5 验证环境与常见问题排查
进入编辑器后，可以通过以下方式验证环境是否正常工作：
- 创建测试流程： 从左侧调色板拖入一个
inject节点和一个debug节点，连接后点击inject的按钮，在右侧调试面板查看输出。 - 检查版本信息： 点击右上角菜单 → 帮助 → 关于，确认Node-RED和Node.js版本与预期一致。
验证结果： 如果调试面板显示
payload: timestamp 或自定义消息，说明Node-RED运行正常，开发环境搭建成功。
常见问题排查表
| 问题现象 | 可能原因 | 解决方案 |
|---|---|---|
node 命令找不到 |
Node.js未添加到系统PATH | 重新安装并勾选"Add to PATH"；或手动添加环境变量 |
npm install -g node-red 报权限错误 |
Linux/macOS 权限不足 | 使用 sudo npm install -g node-red 或配置npm全局目录 |
浏览器无法访问 localhost:1880 |
服务未启动或端口被占用 | 检查终端是否显示"Server now running"；尝试 node-red -p 1881 |
| 编辑器加载缓慢或空白 | 浏览器缓存问题或网络代理 | 清除浏览器缓存；关闭VPN或代理；使用无痕模式 |
2.6 开发环境目录结构
Node-RED首次启动后，会在用户目录下创建 .node-red 文件夹，存放配置文件和用户数据。了解目录结构有助于后续管理和备份。
备份建议： 定期备份
~/.node-red 目录下的 flows.json 和 settings.js 文件，避免因系统重装或误操作导致流程丢失。