NVM 管理 Node Ubuntu版

NVM项目地址

NVM项目地址

一、NVM 基础安装（Ubuntu 必用）

  1. 安装依赖（可选，解决编译报错）
1
sudo apt update && sudo apt install -y build-essential libssl-dev libpng-dev
  1. 安装最新版 NVM（官方推荐）
  • crul
1
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.4/install.sh | bash
  • wget
1
wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.4/install.sh | bash
  1. 生效 NVM 命令（无需重启终端）
1
source ~/.bashrc
  1. 验证安装成功
1
nvm --version
1
nvm -v

二、NVM 核心命令（Node 版本管理）

  1. 查看可安装的 Node 版本
  • 查看所有可用版本（含历史版）
1
nvm ls-remote
  • 只查看 LTS 长期支持版（推荐生产环境）
1
nvm ls-remote --lts
  1. 安装指定版本 Node.js
  • 安装最新版
1
nvm install node
  • 安装最新 LTS 版（推荐）
1
nvm install --lts
  • 安装指定版本（例：20.10.0）
1
nvm install 20.10.0
  1. 查看已安装的 Node 版本
1
nvm ls
  1. 切换 Node 版本
  • 临时切换（当前终端生效）
1
nvm use 20.10.0
  • 切换为最新 LTS
1
nvm use --lts
  • 设置默认版本（重启终端自动生效）
1
nvm alias default 20.10.0
  1. 查看当前使用的 Node 版本
1
2
3
node -v
npm -v
nvm current
  1. 卸载 Node 版本
  • 卸载指定版本
1
nvm uninstall 20.10.0

三、NVM 高级配置命令

  1. 查看 NVM 配置路径
  • NVM 安装目录
1
echo $NVM_DIR
  • Node 安装路径
1
2
which node
which npm
  1. 修复 NVM 命令不生效（Ubuntu 常见问题）
  • 手动加载 NVM 环境变量
1
2
3
echo 'export NVM_DIR="$HOME/.nvm"' >> ~/.bashrc
echo '[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"' >> ~/.bashrc
echo '[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"' >> ~/.bashrc
  • 重新生效
1
source ~/.bashrc

四、NVM 卸载 / 重置（彻底清理）

  1. 卸载 NVM 及其所有 Node 版本
  • 删除 NVM 目录
1
rm -rf ~/.nvm
  • 删除环境变量配置
1
2
sed -i '/NVM_DIR/d' ~/.bashrc
sed -i '/nvm.sh/d' ~/.bashrc
  • 生效清理
1
source ~/.bashrc

五、Ubuntu 专用故障排查命令

  1. 终端重启后 NVM 命令消失
  • 永久修复：执行上面「修复 NVM 不生效」命令
1
source ~/.bashrc
  1. 安装 Node 失败（权限 / 网络）
  • 清理缓存
1
nvm cache clear
  • 重新安装
1
nvm install 18 --reinstall-packages-from=current
  1. 系统全局 Node 与 NVM 冲突
  • 卸载系统全局 Node
1
2
sudo apt remove -y nodejs npm
sudo apt autoremove -y