解决 Ubuntu 16 中 npm 安装提示 Node.js 版本过低及升级错误

2020-09-08 · Ryan · 发表评论

问题描述

在 Ubuntu 16.04 系统上执行 npm install 命令时，提示 Node.js 版本过低。错误信息通常为：wanted: node >=6 current: node 4.2.6 npm 3.5.2。这表明当前系统安装的 Node.js 版本（4.2.6）低于项目所需的最低版本（6.x）。

错误原因

Ubuntu 16.04 默认软件仓库中的 Node.js 版本较旧（如 v4.2.6），无法满足现代 npm 包或项目的版本要求。

标准升级方法

推荐使用 NodeSource 提供的官方仓库或 Node 版本管理工具 n 来安装新版 Node.js。

方法一：使用 NodeSource 仓库（推荐）

此方法能直接安装最新的 LTS 或 Current 版本。

# 1. 清理旧版本（可选）
sudo apt-get remove --purge nodejs npm

# 2. 添加 NodeSource 仓库（以 Node.js 18 LTS 为例）
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -

# 3. 安装 Node.js 和 npm
sudo apt-get install -y nodejs

# 4. 验证安装
node --version
npm --version

方法二：使用 Node 版本管理器 n

如果你需要灵活切换多个 Node.js 版本，可以使用 n。

# 1. 安装一个较新的 Node.js 版本作为 n 的运行环境（例如通过 NodeSource）
# 参考方法一，先安装 Node.js 18 LTS。

# 2. 全局安装 n
sudo npm install -g n

# 3. 使用 n 安装指定版本的 Node.js
# 安装最新的 LTS 版本
sudo n lts
# 或安装最新稳定版
sudo n latest
# 或安装特定版本，如 16.x
sudo n 16

# 4. 验证版本
node --version

解决升级过程中的语法错误

在执行 sudo n stable 等命令时，可能会遇到如下错误：

SyntaxError: Block-scoped declarations (let, const, function, class) not yet supported outside strict mode
    at exports.runInThisContext (vm.js:53:16)
    at Module._compile (module.js:374:25)
    at Object.Module._extensions..js (module.js:417:10)
    at Module.load (module.js:344:32)
    at Function.Module._load (module.js:301:12)
    at Function.Module.runMain (module.js:442:10)
    at startup (node.js:136

原因分析：此错误表明你当前用来运行 n 命令的 Node.js 版本本身太旧（如 v4.x），无法解析 n 工具源码中的 ES6 语法（如 let, const）。

解决方案：你需要先绕过旧版 Node.js，直接获取并运行新版的 n 二进制文件。

# 1. 彻底清除可能存在的旧版 n
sudo npm uninstall -g n
sudo rm -rf /usr/local/n
sudo rm -rf /usr/local/bin/n

# 2. 使用 curl 直接下载并安装 n（此脚本会自动安装一个足够新的 Node.js 来运行 n）
curl -L https://raw.githubusercontent.com/tj/n/master/bin/n -o n
# 安装最新的 LTS 版本
sudo bash n lts
# 或者，如果上述命令不行，尝试指定安装路径
# sudo bash n lts --dest /usr/local

# 3. 安装完成后，再次通过 npm 全局安装 n（此时 Node.js 已更新，可以正常安装）
sudo npm install -g n

# 4. 现在可以正常使用 n 命令切换版本了
sudo n lts
# 或
sudo n latest

# 5. 验证
node --version
which node

总结与建议

对于 Ubuntu 16.04： 系统默认的 Node.js 版本已严重过时，不推荐使用 apt-get install nodejs-legacy 安装。
首选方案： 使用 NodeSource 仓库（方法一）安装一个较新的 LTS 版本（如 18.x）。这是最直接、最不容易出错的方法。
多版本管理： 如果需要管理多个项目或版本，在通过 NodeSource 安装了一个基础版本后，再使用 n 或 nvm 进行版本切换。
路径问题： 安装后如果 node 命令未找到，可以尝试注销并重新登录，或执行 hash -r 来刷新 shell 的缓存路径。

遵循以上步骤，你应该能顺利在 Ubuntu 16.04 上将 Node.js 和 npm 升级到满足要求的版本。