Ubuntu 安装 Node.js 超详细指南(2026最新,4种方法适配所有场景)

32次阅读
没有评论

Node.js 作为基于 Chrome V8 引擎的 JavaScript 运行时环境,是前端工程化、后端开发的核心工具,而 Ubuntu 作为最流行的 Linux 发行版,是很多开发者的首选系统。今天就给大家整理4种最实用的 Ubuntu 安装 Node.js 方法,从新手快速上手到开发者多版本管理,从服务器部署到特殊场景适配,全程手把手教学,避开所有常见坑!

先说明:本文适配 Ubuntu 20.04、22.04、24.04、26.04 等主流版本,所有命令均经过实测可直接复制执行,文末附高频问题排查,新手也能一次成功。

方法一:APT 官方源安装(最简单,适合临时使用)

这是 Ubuntu 系统自带的安装方式,无需额外配置,一条命令就能完成,适合临时跑脚本、测试简单项目,缺点是版本由 Ubuntu 官方维护,通常较旧且可能已停止维护

具体步骤:

  1. 更新系统软件源(必做,避免依赖冲突): sudo apt update
  2. 安装 Node.js 和 npm(npm 是 Node.js 自带的包管理器): sudo apt install -y nodejs npm
  3. 验证安装是否成功: 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 项目。

具体步骤:

  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
  3. 指定要安装的 Node.js 版本(重点!按需修改): NodeSource 目前支持4个主要版本,可根据项目需求替换以下命令中的 NODE_MAJOR 变量:以安装 24.x 版本(推荐)为例,执行以下命令: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
    1. NODE_MAJOR=25:最新版,含最新特性,支持周期较短
    2. NODE_MAJOR=24:活跃 LTS 版,推荐新项目使用
    3. NODE_MAJOR=22:维护期 LTS 版,稳定性高
    4. NODE_MAJOR=20:即将停止支持,不建议新项目使用
  4. 刷新源并安装 Node.js: sudo apt update sudo apt install -y nodejs
  5. 验证安装: 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 包,彻底解决版本冲突问题,是本地开发、多项目并行的最佳选择。

具体步骤:

  1. 安装 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
  2. 使 NVM 立即生效(无需重启终端): source ~/.bashrc如果使用 zsh 终端,执行:source ~/.zshrc
  3. 验证 NVM 安装成功:nvm --version # 应显示 0.40.4 及以上版本
  4. 使用 NVM 安装 Node.js:
    1. 安装最新 LTS 版本(推荐,稳定性高):nvm install --lts
    2. 安装指定大版本(如 22.x):nvm install 22
    3. 安装精确版本(如 24.1.0):nvm install 24.1.0
    4. 安装最新稳定版:nvm install node
  5. 切换 Node.js 版本: nvm use 22 # 切换到 22.x 版本 nvm use --lts # 切换到最新 LTS 版本
  6. 设置默认版本(新开终端自动生效):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 流水线、容器化部署)。

具体步骤:

  1. 下载对应版本的二进制包: 访问 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
  2. 解压二进制包到指定目录(建议解压到 ~/node 目录): mkdir -p ~/node tar -xJf node-v24.1.0-linux-x64.tar.xz -C ~/node
  3. 配置环境变量(让系统识别 node 和 npm 命令): echo 'export PATH="$HOME/node/node-v24.1.0-linux-x64/bin:$PATH"' >> ~/.bashrc使环境变量生效:source ~/.bashrc
  4. 验证安装: node -v npm -v

补充:二进制包自带的 npm 版本可能滞后,安装后可执行 npm install -g npm@latest 升级到最新版;卸载时只需删除解压目录和环境变量配置即可。

安装后必做:npm 镜像源优化(解决下载慢问题)

默认 npm 镜像源在国外,国内下载包速度较慢,建议配置国内镜像源(二选一即可):

  1. 全局配置官方中国镜像(推荐): npm config set registry https://registry.npmmirror.com
  2. 全局配置淘宝镜像: npm config set registry https://registry.npm.taobao.org
  3. 验证镜像源配置: 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 的完整指南,不管你是新手还是资深开发者,都能找到适合自己的方法。如果遇到其他问题,欢迎在评论区留言,一起交流解决~

正文完
可以使用微信扫码关注公众号(ID:xzluomor)
post-qrcode
 0
评论(没有评论)
验证码