系统极客一直在努力
专注操作系统及软件使用技能

如何在 Ubuntu 上安装 Node.js 和 npm

Node.js

Node.js 是基于 Chrome V8 引擎的开源 JavaScript 运行时环境,它跳出了浏览器的环境限制,常用来构建 API、命令行工具和服务端应用,npm 则是和它默认绑定的包管理器。

以下是在 Ubuntu 上安装 Node.js 和 npm 的 3 种主流方法:

  1. NodeSource 仓库:可以精确指定版本,目前支持安装 v25.x、v24.x、v22.x 和 v20.x。
  2. NVM(Node Version Manager):本地多版本管理脚本,开发者首选。
  3. Ubuntu 官方仓库:操作最简单,Ubuntu 26.04 LTS 官方源自带 v22.x,足以应对常规需求。

在 Ubuntu 上安装 Node.js 和 npm

方法 1:通过 NodeSource 仓库安装

NodeSource 官方维护了专属的 APT 软件源。如果生产环境需要固定特定大版本,这是最稳妥的方案。

1安装基础依赖:

sudo apt update
sudo apt install ca-certificates curl gnupg

2导入 NodeSource GPG 密钥,用于校验安装包签名:

sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://deb.nodesource.com/gpgkey/nodesource-repo.gpg.key | sudo gpg --dearmor --batch --yes -o /etc/apt/keyrings/nodesource.gpg

3NodeSource 目前维护的 4 个主要分支有:

版本变量版本类型代号说明
NODE_MAJOR=25当前最新版包含最新特性,支持周期较短
NODE_MAJOR=24活跃 LTSKrypton推荐新项目使用
NODE_MAJOR=22维护期 LTSJod
NODE_MAJOR=20维护期 LTSIron即将停止支持,不建议新项目使用

我们就以安装 v24 版本为例,如需其他版本,只要修改第一行代码的NODE_MAJOR=24变量即可:

NODE_MAJOR=24
cat <<EOF | sudo tee /etc/apt/sources.list.d/nodesource.sources
Types: deb
URIs: https://deb.nodesource.com/node_$NODE_MAJOR.x
Suites: nodistro
Components: main
Signed-By: /etc/apt/keyrings/nodesource.gpg
EOF

4写入源配置后,刷新软件源并安装:

sudo apt update
sudo apt install nodejs
添加 nodesource 源并安装 node.js
添加 nodesource 源并安装 node.js

这里的nodejs软件包已经同时包含了nodenpm这两个二进制文件。

5安装完成后,查看版本号:

node --version
npm --version
查看 node 和 npm 版本
查看 node 和 npm 版本

6如果项目需要通过 npm 编译原生 C/C++ 扩展包,还需要安装完整构建工具链:

sudo apt install build-essential

方法 2:通过 NVM 构建多版本 Node.js 开发环境

NVM 是一款轻量级 Bash 脚本,支持独立管理多个 Node.js 版本。如果你需要在不同项目之间切换环境,它是最方便的方案。

1拉取并执行安装脚本:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.4/install.sh | bash

不要加 sudo 执行,不然环境变量会被写入 root 用户的 Home 目录,普通用户无法调用命令。

2脚本会自动把仓库克隆到~/.nvm目录,并在 Shell 配置文件末尾添加启动代码:

# 终端输出示例
=> Compressing and cleaning up git repository

=> Appending nvm source string to /root/.bashrc
=> Appending bash_completion source string to /root/.bashrc
=> Close and reopen your terminal to start using nvm or run the following to use it now:

export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"  # This loads nvm
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"  # This loads nvm bash_completion
拉取并执行 NVM 脚本
拉取并执行 NVM 脚本

3你可以直接关闭 → 重新打开终端,或者手动粘贴上述export代码段,让 NVM 在当前会话立即生效。

4验证安装状态:

nvm -v

5查看可安装的 Node.js 版本:

# 列出所有可用版本
nvm list-remote

# 列出所有可用 LTS 版本
nvm ls-remote --lts
通过 NVM 列出所有可用 LTS 版本
通过 NVM 列出所有可用 LTS 版本

6一键安装:

# 安装最新版本
nvm install node

# 安装最新 LTS 版本
nvm install --lts

# 安装指定版本
nvm install 22

7查看已安装的所有版本:

nvm ls
通过 NVM 安装指定 Node.js 版本
通过 NVM 安装指定 Node.js 版本

前缀箭头-> v24.15.0表示当前激活的版本;带有default标签的是每次新开终端时,自动加载的默认版本。

8切换当前使用的 Node.js 版本:

nvm use 24

9设置全局默认版本:

nvm alias default 24
通过 NVM 切换当前和默认 Node.js 版本
通过 NVM 切换当前和默认 Node.js 版本

方法 3:通过 Ubuntu 官方仓库安装

Ubuntu LTS 的官方软件源自带了 nodejs 和 npm 包,但版本迭代极其滞后。如果你需要用到新特性,还是推荐使用 NodeSource 或 NVM 方案。

Ubuntu 版本默认 nodejs默认 npm上游状态
Ubuntu 26.04 LTS22.x9.2.x维护中的 LTS
Ubuntu 24.04 LTS18.x9.2.x生命周期结束
Ubuntu 22.04 LTS12.x8.5.x生命周期结束

1直接执行安装命令:

sudo apt update
sudo apt install nodejs npm
通过官方源在 Ubuntu 上安装 Node.js 和 npm
通过官方源在 Ubuntu 上安装 Node.js 和 npm

2验证结果:

node --version
npm --version

从 Ubuntu 上卸载 Node.js

  • 通过 Ubuntu 官方源安装
sudo apt remove --purge -y nodejs npm
sudo apt autoremove -y
rm -rf ~/.npm
  • 通过 NodeSource 安装
sudo apt remove --purge -y nodejs
sudo apt autoremove -y
sudo rm -f /etc/apt/sources.list.d/nodesource.sources
sudo rm -f /etc/apt/keyrings/nodesource.gpg
sudo apt update
rm -rf ~/.npm

  • 通过 NVM 脚本安装(可以移除单个 Node.js 版本,也可以彻底卸载 NVM):
# 加载 NVM 环境到当前 Shell
source ~/.nvm/nvm.sh
# 查看当前激活的 Node.js 版本
nvm current

# 停用当前会话 NVM 环境,卸载 v24 版本
nvm deactivate
nvm uninstall 24

# 删除 NVM 本体、所有已装 Node 版本及配置
rm -rf ~/.nvm
# 清除 npm 全局缓存与全局包数据
rm -rf ~/.npm

通过以上 3 种方法,你就可以轻松在 Ubuntu 上安装 Node.js 和 npm。其中,NodeSource 适合固定版本的生产环境,NVM 适合多版本切换的开发场景,Ubuntu 官方源适合快速部署基础环境。请根据你自己的实际需求进行选择。

赞(0)
分享到

评论 抢沙发