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

相关推荐
FungLeo7 小时前
成为全栈·Node 后端篇·配置管理:环境变量、多环境与密钥安全
node.js·环境变量·多环境配置·密钥安全
FungLeo8 小时前
成为全栈·Node 后端篇·错误处理:异常分层与全局捕获
node.js·错误处理·异常分层·全局捕获·成为全栈
YHHLAI13 小时前
TypeScript 高级工具类型面试指南
ubuntu·面试·typescript
CS_Zero14 小时前
Ubuntu 22.04挂载新硬盘
linux·运维·ubuntu
晚风叙码15 小时前
Linux(三)apt/yum 软件安装与 vim 编辑器入门指南
linux·编辑器·vim
洪流之源15 小时前
Windows 远程 Ubuntu 24.04 桌面
linux·windows·ubuntu
百万运营Pro16 小时前
用 Astro + Supabase 从零构建全网盘聚合搜索引擎:PGroonga 中文检索实战
搜索引擎·前端框架·node.js·个人开发·学习方法·ai编程·资源分享
一直C1 天前
Linux网络编程|HTTP协议详解(报文、请求方法、状态码)
linux·http·wireshark·vim·visual studio
小婉1 天前
我用 Next.js + React Flow 从零搭建了一个可视化 AI 工作流编排平台
前端·人工智能·node.js
抓不住时间的沙1 天前
N1搭建守护环境以及重装 Armbian 后完整恢复整套守护环境,清理日志步骤
node.js