Node-RED的function节点需严格遵循CommonJS规范,禁用import/require/async-await,代码须包裹在function内并仅返回msg,使用global.get/set管理状态,JSON解析前必须try/catch校验payload类型。

Sublime Text里怎么写Node-RED能直接用的JavaScript函数
Node-RED的function节点本质是运行在Node.js环境里的CommonJS模块,但不支持ES6 import、顶层await或require绝对路径——Sublime Text里写的脚本必须严格遵循它的执行上下文。你不能把本地调试好的async/await函数直接粘过去,也不能用fetch()(Node-RED默认没开)。
- 所有代码必须包裹在
function函数体里,且只能返回msg或msg数组,别写console.log——它不会输出到Node-RED调试面板 - 要用
global.get()和global.set()代替全局变量,否则热重载后状态丢失 - JSON.parse()前务必加try/catch,Node-RED里
msg.payload可能是string、buffer或null,不校验会直接中断流 - Sublime Text里可装
JavaScript (Babel)插件辅助语法高亮,但别依赖ESLint规则——Node-RED用的是V8 14.x,不支持?.和??
Node-RED里报ReferenceError: require is not defined怎么办
这是最常踩的坑:你在Sublime Text里写了const axios = require('axios'),一粘进function节点就崩。Node-RED的function节点默认禁用require,不是权限问题,是沙箱机制硬性限制。
- 第三方库必须通过Node-RED的
package.json安装到~/.node-red/node_modules,再在设置里勾选Function Node: Enable external modules - 启用后仍不能用
require('fs')或require('child_process')——这些被明确黑名单了 - 真正安全的替代方案是用Node-RED内置的
http request节点发HTTP请求,或改用node-red-contrib-http-request这类白名单封装包 - 如果非要动态加载,得走
global.get('axios')方式,前提是你已在启动时用settings.js注入过
Sublime Text保存后Node-RED不生效?检查这三处缓存
Node-RED不会监听文件系统变化,你用Sublime Text编辑完再切回浏览器点Deploy,很可能跑的还是旧逻辑。这不是IDE问题,是Node-RED自身的热更新盲区。
根据 package.json 中的 engines 字段自动检测 Node.js 版本需求,未安装 nvm 时自动安装并切换至对应版本。支持 Windows、macOS、Linux。适用于 Node.js 项目开发、版本切换和环境配置。
- function节点内容是存在
flows_<hostname>.json</hostname>里的,Sublime Text里改的只是你的草稿副本——必须手动复制粘贴到Node-RED编辑器,或用Import功能导入JSON片段 - 如果启用了
editorTheme配置中的fileEditor,要确认fileEditor.path指向的是Node-RED实际读取的flow文件路径,而不是你随便建的临时目录 - 浏览器端有Service Worker缓存,Ctrl+F5硬刷新还不够,得打开开发者工具→Application→Clear storage→勾选Cache Storage再清空
调试时msg对象结构总对不上,先看payload类型
Node-RED里msg.payload可能是Buffer、String、Object、null,甚至Date——取决于上游节点。Sublime Text里写的逻辑如果假设它是Object,到真实设备数据进来就炸。
- 用
typeof msg.payload === 'string'判断后再JSON.parse(),比直接JSON.parse(msg.payload)安全 - MQTT节点传过来的payload默认是Buffer,得先
msg.payload.toString(),否则JSON.parse报Unexpected token - 调试时别只打
node.warn(JSON.stringify(msg)),Buffer会被转成空对象{},应该用node.warn(util.inspect(msg, {depth: null}))(需提前const util = global.get('util')) - Sublime Text里写辅助函数时,建议开头加
if (!msg || !msg.payload) return;,避免空消息流触发后续错误
真正的麻烦不在语法,而在Node-RED每个节点对msg字段的隐式修改——比如change节点会静默覆盖msg.topic,而function节点根本不知道上游干了什么。多打node.warn比猜强。

















