Ubuntu 20.04/22.04 下通过 NVM 安装 Node.js 22(LTS 稳定版)

引言

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 已成功安装并可用。

六、常见问题与解决方法

  1. 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
  2. 执行 nvm 命令提示 "command not found":重新执行 ~/.nvm/nvm.sh 加载环境,或检查 ~/.bashrc/~/.zshrc 中的环境变量配置是否正确。

  3. 安装 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 等主流版本,操作简洁且稳定,适合开发环境快速搭建。

相关推荐
冴羽2 小时前
100s 带你了解 Bun 为什么这么火
前端·node.js·bun
Gogo11214 小时前
架构的宿命:深入对比 NestJS (Node.js) 与 Java 的垃圾回收机制
java·node.js
The️7 小时前
Linux驱动开发之Read_Write函数
linux·运维·服务器·驱动开发·ubuntu·交互
硬汉嵌入式8 小时前
Vim 9.2版本正式发布
编辑器·vim
再战300年8 小时前
Samba在ubuntu上安装部署
linux·运维·ubuntu
qwfys2009 小时前
How to install golang 1.26.0 to Ubuntu 24.04
ubuntu·golang·install
木尧大兄弟9 小时前
Ubuntu 系统安装 OpenClaw 并接入飞书记录
linux·ubuntu·飞书·openclaw
朝朝暮暮an10 小时前
Day 5|npm 生态 & 项目工程化基础
node.js
小虾爬滑丫爬10 小时前
ubuntu上设置Tomcat 开机启动
ubuntu·tomcat·开机启动