在 Debian 中更新 Node.js 的常用方法

方法一 使用 NodeSource 存储库 APT 升级

• 适用于希望系统级统一版本、所有用户可用的场景。
• 步骤：
  1. 更新索引并安装依赖 sudo apt update && sudo apt install -y curl ca-certificates gnupg
  2. 添加 NodeSource 仓库（选择其一）
     • 最新 LTS：curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
     • 指定主版本：curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
  3. 升级或安装 sudo apt update && sudo apt install -y nodejs
  4. 验证 node -v npm -v
• 说明：仓库脚本会自动导入 GPG 密钥并配置 APT 源；如需切换版本，重新执行对应版本的 setup 脚本后再次 apt install -y nodejs 即可。

方法二 使用 NVM 管理版本

• 适用于开发者在多项目间切换不同 Node.js 版本，或不想改动系统级环境。
• 步骤：
  1. 安装 NVM curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
  2. 重新加载 shell 配置 source ~/.bashrc # 或 source ~/.zshrc
  3. 安装并使用版本 nvm install --lts # 安装最新 LTS nvm use --lts # 立即使用 LTS

     或安装特定版本：nvm install 20

  4. 验证 node -v npm -v
• 说明：NVM 将 Node 安装在用户目录，互不干扰；如需设为默认版本，执行 nvm alias default 。

方法三 使用系统 APT 直接升级

• 适用于此前已通过 Debian 官方仓库或已配置的第三方源安装的情况。
• 步骤：
  1. 更新索引 sudo apt update
  2. 执行升级 sudo apt upgrade nodejs
  3. 验证 node -v
• 注意：官方仓库通常版本较旧，若需要新版本，请优先使用 NodeSource 或 NVM。

方法四 手动下载二进制包

• 适用于需要特定构建或离线安装的场景。
• 步骤：
  1. 前往 Node.js 官网下载 Linux x64 二进制包（.tar.xz）
  2. 解压并移动到目标路径 tar -xf node-vXX.X.X-linux-x64.tar.xz sudo mv node-vXX.X.X-linux-x64 /usr/local/nodejs
  3. 配置 PATH 在 ~/.bashrc 或 ~/.zshrc 中添加：export PATH=/usr/local/nodejs/bin:$PATH source ~/.bashrc
  4. 验证 node -v npm -v

升级后的注意事项

• 全局包迁移：切换 Node 主版本后，建议重新安装全局包 npm install -g npm@latest

  如需保留既有全局包，可先 npm list -g --depth=0 记录，再批量重装

• 多用户与系统服务：
  • 使用 NVM 时，系统服务（如 systemd）默认不会继承用户环境，需在服务单元中显式设置 PATH 或使用 nvm-wrapped 脚本。
  • 使用 NodeSource 的 APT 安装为系统级，服务可直接使用。
• 版本策略：生产环境优先 LTS，新特性再评估 Current。