CentOS 下 Node.js 版本选择指南

一、选择原则

• 优先选择**LTS（长期支持）**版本，稳定性和生态更好；如需新特性再考虑 Current。
• 以项目的依赖兼容性为最高优先级：不同版本的 Node.js 与 npm 存在对应关系，升级 Node 往往要同步升级 npm 与相关包（如 node-sass、sass-loader 等）。
• 结合操作系统版本与 glibc 要求：老旧系统（如 CentOS 7，glibc 2.17）无法原生运行 Node.js 18+；若必须上 18+，可用 Snap 或容器化方案。
• 团队多项目并存时，使用 NVM 在同一台机器上管理多版本，按项目切换。

二、按 CentOS 版本给出推荐

三、快速安装与切换方式

• 使用 NVM（推荐）：便于多版本并存与按项目切换。示例：
  curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
  source ~/.bashrc
  nvm install 18.20.4
  nvm use 18.20.4
  nvm alias default 18.20.4
  node -v && npm -v
• 使用 NodeSource YUM 仓库（系统级安装，适合稳定环境）：

  例：安装 18.x

  curl -fsSL https://rpm.nodesource.com/setup_18.x | sudo bash -
  sudo yum install -y nodejs
  node -v && npm -v
  如需 16.x，将 18.x 替换为 16.x 即可。
• 在 CentOS 7 上装 Node.js 18+ 的可选方案：
  • 使用 Snap：
    sudo yum install -y snapd && sudo systemctl enable --now snapd.socket
    sudo ln -s /var/lib/snapd/snap /snap
    sudo snap install node --channel=18/stable --classic
    node -v && npm -v
  • 若 Snap 安装后命令未找到，多为 PATH 刷新延迟，稍候或按提示执行 snap refresh。

四、升级与兼容性检查清单

• 核对 Node 与 npm 的对应关系，避免跨大版本导致 npm/依赖异常。
• 升级 Node 后，必要时执行：npm install -g npm@<对应版本>；并重新安装本地依赖（如 rm -rf node_modules && npm install）。
• 常见报错与处理：
  • node-sass 报 “binding 不匹配当前环境” → 升级/重装 node-sass 与 sass-loader 到与 Node 匹配的版本。
  • 构建工具在 Node 升级后异常 → 检查依赖的 engines 字段与 Babel/TypeScript/框架的版本约束，必要时锁定版本。