Ubuntu下Node.js版本如何升级

Ubuntu 下升级 Node.js 的实用方法

方法一 使用 NVM 进行多版本管理（推荐）

• 安装或更新 NVM（Node Version Manager）：
  • 执行安装脚本并加载到当前会话：

    curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
    source ~/.bashrc    # 如使用 zsh 则执行：source ~/.zshrc
    

• 查看并安装目标版本：

  nvm ls-remote                 # 查看远程可用版本
  nvm install --lts              # 安装最新 LTS
  nvm install 22                # 安装指定主版本（示例：22）
  nvm install 18.18.2           # 安装精确版本（示例）
  

• 切换与使用：

  nvm use --lts                  # 临时使用 LTS
  nvm use 22                     # 临时使用指定版本
  nvm alias default 22          # 设置默认版本，新终端自动生效
  

• 验证：

  node -v
  npm -v
  

• 说明：NVM 在同一台机器可并行管理多个 Node.js 版本，互不干扰，适合多项目与团队协作开发。

方法二 使用 NodeSource 的 APT 仓库升级（系统级）

• 更新索引并添加 NodeSource 仓库（以 Node.js 22.x 为例，其他版本将 22.x 替换为目标主版本）：

  sudo apt update
  curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
  

• 安装或升级 nodejs（会替换旧版本）：

  sudo apt install -y nodejs
  

• 验证：

  node -v
  npm -v
  

• 说明：此方法为系统级安装，适合需要统一版本的生产环境；如需从旧版本干净升级，可先执行 sudo apt remove --purge nodejs npm 再安装。

方法三 使用 n 或 fnm 等版本管理工具

• 使用 n（需已安装 Node.js 与 npm）：

  sudo npm install -g n
  n lts              # 安装最新 LTS
  n 22               # 安装指定主版本
  n                  # 交互式选择已安装版本
  sudo n lts         # 在部分系统上可能需要 sudo 写入 /usr/local
  

• 使用 fnm（跨平台、速度快）：

  curl -fsSL https://fnm.vercel.app/install | bash
  source ~/.bashrc
  fnm install --lts
  fnm use --lts
  fnm default 22
  

• 说明：n 与 fnm 都支持多版本切换，适合在 Linux/macOS 上替代或配合现有环境使用。

升级后的兼容性与最佳实践

• 在项目中固定版本：在项目根目录创建 .nvmrc（示例：22 或 lts/*），进入项目后执行 nvm use，保证团队成员与 CI 使用一致版本。
• 全局包迁移：切换 Node 主版本后，建议重新安装全局包（示例思路）：

  npm list -g --depth=0 > global-before.txt
  # 切换 Node 版本后
  npm install -g $(cat global-before.txt | awk '{print $2}')
  

• 验证与回退：升级后用 node -v、npm -v 与项目测试验证；如出现不兼容，使用 nvm use <旧版本> 或 fnm use <旧版本> 快速回退。