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

相关推荐
CodeCaptain1 天前
【六】OpenClaw 从 TUI 切换到 Web 端完整方案
ubuntu·ai·openclaw
木木爱研究1 天前
elpis 全栈里程碑一总结
node.js
夏暖冬凉1 天前
npm发布流程(记录遇到的问题)
前端·npm·node.js
张小五3151 天前
node服务器是什么
node.js
张小五3151 天前
什么是node.js 小白也能看明白
node.js
lew-yu1 天前
websocket后端实现心跳检测,并定时清理异常的连接
websocket·网络协议·vim
SCBAiotAigc1 天前
2026.4.13:vim编程简单配置
人工智能·ubuntu·vim·具身智能
huhy~1 天前
基于Ubuntu 24.04 LTS 搭建OpenStack F 版
android·ubuntu·openstack
Chuncheng's blog1 天前
Ubuntu24.04 如何删除snap
ubuntu
软弹2 天前
快速了解前端中的跨域问题
前端·javascript·vue.js·react.js·node.js·跨域