引言
Node.js 是前端开发、后端服务开发的核心环境,而 NVM(Node Version Manager)作为跨平台的 Node.js 版本管理器,能轻松实现多版本 Node.js 切换、安装与卸载,避免版本冲突问题。本文将详细介绍在 Ubuntu 系统中通过 NVM 安装 Node.js 22(LTS 稳定版)的完整步骤,操作简单且适配主流 Ubuntu 版本,适合开发新手与进阶用户。
一、准备工作:安装依赖工具 curl
Ubuntu 系统默认可能未预装 curl 工具,而后续安装 NVM 需要通过 curl 下载脚本,因此首先需执行以下命令安装 curl:
bash
# 更新 apt 软件源(可选,提升安装稳定性)
sudo apt update
# 安装 curl 工具
sudo apt install -y curl
- 命令说明:
sudo获取管理员权限,apt install -y表示自动确认安装,无需手动输入y确认。 - 验证:安装完成后可输入
curl --version,若输出 curl 版本信息则说明安装成功。
二、安装 NVM(Node 版本管理器)
NVM 官方提供了一键安装脚本,执行以下命令即可下载并安装 NVM v0.40.3 版本(当前稳定版):
bash
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
- 命令解析:
curl -o-表示将远程脚本内容输出到终端并执行,通过管道符| bash交给 bash shell 运行安装逻辑。 - 安装过程:脚本会自动创建 NVM 安装目录(默认
~/.nvm),并配置环境变量。
三、加载 NVM 环境(无需重启终端)
安装完成后,NVM 环境变量尚未立即生效,需手动加载配置文件,执行以下命令即可:
bash
# 加载 NVM 环境(等价于 source ~/.nvm/nvm.sh)
. "$HOME/.nvm/nvm.sh"
-
补充说明:若后续重启终端后 NVM 失效,可检查
~/.bashrc或~/.zshrc文件中是否存在 NVM 自动添加的环境变量配置,若未添加可手动追加以下内容:bash
export NVM_DIR="$HOME/.nvm" [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh" # 加载 NVM [ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion" # 加载 NVM 命令补全(可选)
四、通过 NVM 安装 Node.js 22(LTS 版)
NVM 环境加载成功后,执行以下命令安装 Node.js 22 版本(LTS 版稳定性强,适合生产环境):
bash
nvm install 22
- 安装逻辑:NVM 会自动下载对应系统架构(x64)的 Node.js 22 最新 LTS 版本(当前为 v22.17.0),并自动配置为默认使用版本。
- 等待时间:根据网络速度不同,安装过程可能需要 1-5 分钟,无需额外操作,耐心等待即可。
五、验证安装结果
安装完成后,通过以下命令验证 Node.js 和 npm(Node 自带包管理器)的版本,确认安装成功:
bash
# 验证 Node.js 版本(预期输出:v22.17.0)
node -v
# 验证 npm 版本(预期输出:10.9.2,与 Node.js 22 配套)
npm -v
# 验证 NVM 当前使用的 Node 版本(预期输出:v22.17.0)
nvm current
- 若所有命令均输出预期版本号,则说明 Node.js 22 已成功安装并可用。
六、常见问题与解决方法
-
curl 下载脚本失败:可尝试更换网络,或使用 wget 替代 curl 执行安装(需先安装 wget:
sudo apt install -y wget),命令如下:bash
wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash -
执行
nvm命令提示 "command not found":重新执行~/.nvm/nvm.sh加载环境,或检查~/.bashrc/~/.zshrc中的环境变量配置是否正确。 -
安装 Node.js 时卡住:大概率是网络问题,可中断安装(Ctrl+C)后重新执行
nvm install 22,NVM 会自动续传未完成的文件。
总结
通过 NVM 安装 Node.js 的优势在于灵活管理多版本,后续如需安装其他 Node 版本(如 18.x、20.x),仅需执行 nvm install 版本号 即可,切换版本使用 nvm use 版本号。本文步骤适配 Ubuntu 20.04/22.04 等主流版本,操作简洁且稳定,适合开发环境快速搭建。