Node.js 作为基于 Chrome V8 引擎的 JavaScript 运行时环境,是前端工程化、后端开发的核心工具,而 Ubuntu 作为最流行的 Linux 发行版,是很多开发者的首选系统。今天就给大家整理4种最实用的 Ubuntu 安装 Node.js 方法,从新手快速上手到开发者多版本管理,从服务器部署到特殊场景适配,全程手把手教学,避开所有常见坑!
先说明:本文适配 Ubuntu 20.04、22.04、24.04、26.04 等主流版本,所有命令均经过实测可直接复制执行,文末附高频问题排查,新手也能一次成功。
方法一:APT 官方源安装(最简单,适合临时使用)
这是 Ubuntu 系统自带的安装方式,无需额外配置,一条命令就能完成,适合临时跑脚本、测试简单项目,缺点是版本由 Ubuntu 官方维护,通常较旧且可能已停止维护。
具体步骤:
- 更新系统软件源(必做,避免依赖冲突):
sudo apt update - 安装 Node.js 和 npm(npm 是 Node.js 自带的包管理器):
sudo apt install -y nodejs npm - 验证安装是否成功:
node -v # 查看 Node.js 版本npm -v # 查看 npm 版本
注意事项:Ubuntu 22.04 默认安装 Node.js 12.x(2020年已停止维护),Ubuntu 24.04 默认安装 18.x(2026年4月已停止维护),Ubuntu 26.04 默认安装 22.x(目前可正常使用)。如果你的项目对 Node.js 版本有要求,不建议用这种方法。
方法二:NodeSource 仓库安装(推荐,服务器单项目首选)
NodeSource 是官方维护的第三方 APT 仓库,提供比 Ubuntu 官方源更新、更可控的 Node.js 版本,支持 20.x、22.x、24.x 等主流版本,可精准指定版本,还能通过 apt 统一管理更新,适合服务器部署单一 Node.js 项目。
具体步骤:
- 安装基础依赖,确保能正常添加仓库和校验签名:
sudo apt updatesudo apt install ca-certificates curl gnupg - 导入 NodeSource GPG 密钥(用于验证安装包合法性):
sudo install -m 0755 -d /etc/apt/keyringscurl -fsSL https://deb.nodesource.com/gpgkey/nodesource-repo.gpg.key | sudo gpg --dearmor --batch --yes -o /etc/apt/keyrings/nodesource.gpg - 指定要安装的 Node.js 版本(重点!按需修改): NodeSource 目前支持4个主要版本,可根据项目需求替换以下命令中的
NODE_MAJOR变量:以安装 24.x 版本(推荐)为例,执行以下命令:NODE_MAJOR=24cat <<EOF | sudo tee /etc/apt/sources.list.d/nodesource.sourcesTypes: debURIs: https://deb.nodesource.com/node_$NODE_MAJOR.xSuites: nodistroComponents: mainSigned-By: /etc/apt/keyrings/nodesource.gpgEOF- NODE_MAJOR=25:最新版,含最新特性,支持周期较短
- NODE_MAJOR=24:活跃 LTS 版,推荐新项目使用
- NODE_MAJOR=22:维护期 LTS 版,稳定性高
- NODE_MAJOR=20:即将停止支持,不建议新项目使用
- 刷新源并安装 Node.js:
sudo apt updatesudo apt install -y nodejs - 验证安装:
node -v # 应显示 v24.x.x(具体版本以实际安装为准)npm -v # 自动捆绑安装,无需额外操作
补充:如果项目需要编译原生 C/C++ 扩展包(如一些 npm 插件),需额外安装构建工具链:sudo apt install build-essential。
方法三:NVM 安装(开发者首选,多版本共存)
NVM(Node Version Manager)是一款轻量级的 Node.js 版本管理工具,可在同一台机器上安装多个 Node.js 版本,一键切换,无需 sudo 权限安装全局 npm 包,彻底解决版本冲突问题,是本地开发、多项目并行的最佳选择。
具体步骤:
- 安装 NVM(使用最新版安装脚本,无需 sudo):
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.4/install.sh | bash如果没有 curl,可使用 wget 替代:wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.4/install.sh | bash - 使 NVM 立即生效(无需重启终端):
source ~/.bashrc如果使用 zsh 终端,执行:source ~/.zshrc - 验证 NVM 安装成功:
nvm --version # 应显示 0.40.4 及以上版本 - 使用 NVM 安装 Node.js:
- 安装最新 LTS 版本(推荐,稳定性高):
nvm install --lts - 安装指定大版本(如 22.x):
nvm install 22 - 安装精确版本(如 24.1.0):
nvm install 24.1.0 - 安装最新稳定版:
nvm install node
- 安装最新 LTS 版本(推荐,稳定性高):
- 切换 Node.js 版本:
nvm use 22 # 切换到 22.x 版本nvm use --lts # 切换到最新 LTS 版本 - 设置默认版本(新开终端自动生效):
nvm alias default 24 # 将 24.x 设为默认版本
NVM 常用命令(必记):
nvm ls # 查看已安装的所有 Node.js 版本
nvm current # 查看当前使用的版本
nvm ls-remote --lts # 查看所有可用的 LTS 版本
nvm uninstall 22 # 卸载 22.x 版本
方法四:二进制包安装(特殊场景适配,高度可控)
二进制包安装无需依赖系统包管理器,直接下载官方预编译文件,解压后配置环境变量即可使用,适合无 root 权限、企业内网禁用 apt 工具,或需要精确控制环境的场景(如 CI/CD 流水线、容器化部署)。
具体步骤:
- 下载对应版本的二进制包: 访问 Node.js 官方下载页,选择 Linux 系统、对应架构(x64 或 arm64)的 .tar.xz 包,复制下载链接。以安装 24.1.0 版本(x64 架构)为例,终端执行:
wget https://nodejs.org/dist/v24.1.0/node-v24.1.0-linux-x64.tar.xz - 解压二进制包到指定目录(建议解压到 ~/node 目录):
mkdir -p ~/nodetar -xJf node-v24.1.0-linux-x64.tar.xz -C ~/node - 配置环境变量(让系统识别 node 和 npm 命令):
echo 'export PATH="$HOME/node/node-v24.1.0-linux-x64/bin:$PATH"' >> ~/.bashrc使环境变量生效:source ~/.bashrc - 验证安装:
node -vnpm -v
补充:二进制包自带的 npm 版本可能滞后,安装后可执行 npm install -g npm@latest 升级到最新版;卸载时只需删除解压目录和环境变量配置即可。
安装后必做:npm 镜像源优化(解决下载慢问题)
默认 npm 镜像源在国外,国内下载包速度较慢,建议配置国内镜像源(二选一即可):
- 全局配置官方中国镜像(推荐):
npm config set registry https://registry.npmmirror.com - 全局配置淘宝镜像:
npm config set registry https://registry.npm.taobao.org - 验证镜像源配置:
npm config get registry
如果需要切换镜像源,可安装 nrm 工具:npm install -g nrm,通过 nrm ls 查看所有镜像源,nrm use taobao 快速切换。
高频问题排查(新手必看)
1. 执行 node -v 显示 “command not found”
– 原因:环境变量未配置或未生效。解决方案:重新执行 source ~/.bashrc,或检查环境变量配置路径是否正确。
– 若使用 NVM,确认已执行 nvm use 版本号,且已设置默认版本。
2. npm 全局安装包报 EACCES 权限错误
– 原因:APT/NodeSource 安装方式下,全局 npm 包默认安装到系统目录,需要 sudo 权限。
– 解决方案:使用 NVM 安装(从根本上解决),或执行 sudo chown -R $(whoami) ~/.npm 赋予权限。
3. 安装后版本不对(如安装 24.x 却显示 18.x)
– 原因:系统中存在多个 Node.js 版本,优先级冲突。
– 解决方案:用 which node 查看当前 node 路径,删除旧版本(APT 安装可执行 sudo apt purge nodejs npm),或用 NVM 切换到正确版本。
4. NVM 安装后重启终端失效
– 原因:NVM 环境变量未写入对应的 shell 配置文件。
– 解决方案:将 export NVM_DIR="$HOME/.nvm" && [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh" 手动添加到 ~/.bashrc 或 ~/.zshrc 中,再执行 source ~/.bashrc。
总结:4种方法怎么选?
- 临时使用、简单测试 → APT 官方源(最快,版本旧)
- 服务器部署、单一项目 → NodeSource 仓库(版本可控,apt 统一管理)
- 本地开发、多项目并行 → NVM(多版本切换,无需 sudo,开发者首选)
- 特殊场景(无 root、内网) → 二进制包(高度可控,手动配置)
以上就是 Ubuntu 安装 Node.js 的完整指南,不管你是新手还是资深开发者,都能找到适合自己的方法。如果遇到其他问题,欢迎在评论区留言,一起交流解决~