温馨提示×

ubuntu装nodejs出错怎么办

小樊
36
2026-09-19 00:01:05
栏目: 编程语言

在 Ubuntu 上安装 Node.js 出错很常见,通常和源、权限、架构、旧版本冲突有关。下面按「最常见原因 → 对应解决办法」给你一套排查思路,基本能解决 90% 的问题。


一、先看错误信息(最关键)

先把完整报错贴出来(尤其是 E:Errorpermission denied404 这类)。
常见错误类型:

  • E: Unable to locate package nodejs
  • E: Failed to fetch ... 404
  • permission denied
  • command not found: node

二、最推荐的安装方式(不容易出错)

✅ 方式 1:用 NodeSource(官方推荐)

sudo apt update
sudo apt install -y curl

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs

验证:

node -v
npm -v

20.x 换成你需要的版本(18.x / 22.x 也可以)


三、常见错误 & 解决办法

1️⃣ Unable to locate package nodejs

原因:软件源没更新或系统太老
解决:

sudo apt update
sudo apt upgrade

再重试安装


2️⃣ Failed to fetch ... 404

原因:Ubuntu 版本太老(如 18.04 已停止支持)
解决:

  • 升级系统
  • 或用 NodeSource(见上面)

3️⃣ permission denied

原因:用 sudo 装了全局包
解决(推荐):

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

4️⃣ 已有旧 Node 冲突

which node
sudo apt remove nodejs
sudo apt autoremove

再重装


5️⃣ 用 nvm(最稳,适合开发)

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
nvm install 20

四、如果你愿意

你可以直接把报错原文贴出来,我可以:

  • 精确判断是哪一步错
  • 给你一条对应命令
  • 甚至区分你是 服务器 / 桌面 / WSL

你现在是哪种情况?

0