Node-Red 常見安裝錯誤與解決方案

Node-Red 常見安裝錯誤與解決方案

 安裝 Node-RED 失敗通常是因為 Node.js 版本不相容、權限不足（Windows 使用 sudo 或 --unsafe-perm）或 npm 快取問題。建議先確認 Node.js (LTS 版本) 安裝，並使用管理員權限執行安裝指令 npm install -g --unsafe-perm node-red。 

常見安裝錯誤與解決方案

• 權限問題 (EACCES/Permissions):
  • 原因: Linux/macOS 下全域安裝缺少 sudo。
  • 解決方案: 使用 sudo npm install -g --unsafe-perm node-red。
• 權限問題 (Windows):
  • 解決方案: 以「系統管理員身分」開啟 cmd 或 PowerShell 再執行指令。
• Node.js 版本不相容:
  • 解決方案: Node-RED 建議使用 Node.js LTS 版本 (例如 v18 或 v20)。若安裝較新版本失敗，請下載並安裝最新的 Node.js LTS。
• Node-gyp 錯誤 (依賴庫編譯失敗):
  • 解決方案: 需要環境配置 (Python, C++ 編譯器)。嘗試安裝編譯工具: npm install --global windows-build-tools (Windows 管理員下執行)。
• 安裝卡住或網路錯誤:
  • 解決方案: 清除快取並重試：npm cache clean --force。 

基本安裝指令 (Windows/macOS/Linux)

bash

# 1. 檢查 node 和 npm 版本 (確認安裝了 LTS 版本)
node --version
npm --version

# 2. 全域安裝 Node-RED (加上 --unsafe-perm 解決權限導致的安裝失敗)
npm install -g --unsafe-perm node-red

# 3. 啟動 Node-RED
node-red