在 Debian 上更新 Node.js 的常用方法
- 使用 NodeSource 仓库(系统级、适合服务器与多用户)
- 使用 NVM(用户级、多版本并存与切换最灵活)
- 使用 n 或 Volta(轻量或多工具链管理)
- 直接下载 二进制包(自定义路径、不依赖包管理器)
方法一 使用 NodeSource 仓库
- 1)更新索引并可选清理旧版本
- sudo apt update
- 如需彻底替换旧包:sudo apt remove --purge nodejs npm && sudo apt autoremove
- 2)添加 NodeSource 仓库(将 20.x 替换为目标主版本,如 18.x、22.x)
- curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
- 3)安装或升级 Node.js(同时提供 nodejs 与 npm)
- sudo apt install -y nodejs
- 4)验证
- 说明:NodeSource 提供 LTS 与 Current 系列,适合需要系统级统一版本的场景。
方法二 使用 NVM(Node Version Manager)
- 1)安装 NVM(示例版本 v0.39.7,可按需调整)
- curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
- 重新加载 shell 配置:source ~/.bashrc(或 ~/.zshrc)
- 2)查看并安装版本
- 查看远程版本:nvm ls-remote
- 安装最新 LTS:nvm install --lts
- 安装最新稳定版:nvm install node
- 安装指定版本:nvm install 18.18.2
- 3)切换与使用
- 临时切换:nvm use 18.18.2
- 设为默认:nvm alias default 18.18.2
- 4)验证
- 说明:NVM 在同一台机器管理多版本最方便,适合开发与测试环境。
方法三 使用 n 或 Volta
- 使用 n(需已安装 Node 与 npm)
- 全局安装 n:sudo npm install -g n
- 升级到指定版本:sudo n 20.18.0
- 切换使用:n(交互式选择)
- 使用 Volta(跨项目统一工具链)
- 安装:curl https://get.volta.sh | bash
- 安装并固定版本:volta install node@20.18.0;volta pin node@20.18.0
- 说明:n 轻量;Volta 可同时管理 Node.js/npm/yarn 并支持项目级版本固定。
方法四 直接下载二进制包
- 1)下载并解压(示例为 Linux x64)
- wget https://nodejs.org/dist/v20.18.0/node-v20.18.0-linux-x64.tar.xz
- tar -xf node-v20.18.0-linux-x64.tar.xz
- 2)移动到系统目录并配置 PATH
- sudo mv node-v20.18.0-linux-x64 /usr/local/nodejs
- echo ‘export PATH=/usr/local/nodejs/bin:$PATH’ >> ~/.bashrc
- source ~/.bashrc
- 3)验证
- 说明:路径与版本号可按需调整,适合对目录结构有自定义需求的场景。
版本选择与注意事项
- 优先选择 LTS 版本(如 18.x、20.x),兼顾稳定性与安全性;Current 版本适合尝鲜与验证。
- 升级前备份项目与依赖;升级后在测试环境充分验证,避免 API/依赖 不兼容。
- 统一开发与生产环境的 Node 版本(如使用 .nvmrc 或 Volta pin),减少“在我机器上能跑”的问题。
- 若通过 apt 安装过旧版,建议先 purge 再添加 NodeSource 或使用 NVM,避免混源冲突。
- 更新 npm:npm install -g npm@latest;如使用 n,也可用 n 升级 Node 后再同步更新 npm。