“Ubuntu 下 Node.js 报错”范围很广,不同报错原因不同。你可以先把完整的报错信息贴出来,我才能精准帮你。
不过,下面先给你一份 Ubuntu 上 Node.js 常见报错 & 通用解决办法,你可以对照看看:
command not found: node / node: command not found原因:Node.js 没装或没加入 PATH
✅ 解决:
node -v
如果没版本号:
sudo apt update
sudo apt install nodejs npm
推荐用 NodeSource(版本更新):
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs
EACCES: permission denied / npm ERR! code EACCES原因:用 sudo 装包或全局目录权限问题
✅ 解决(推荐):
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
❌ 不建议:
sudo npm install -g xxx
Cannot find module 'xxx'原因:依赖没装
✅ 解决:
rm -rf node_modules package-lock.json
npm install
Port 3000 is already in use原因:端口被占
✅ 解决:
lsof -i:3000
kill -9 <PID>
或改代码端口
openssl legacy provider 报错(Node 17+)报错示例:
Error: error:0308010C:digital envelope routines::unsupported
✅ 解决:
export NODE_OPTIONS=--openssl-legacy-provider
或升级构建工具
GLIBC / version not found原因:Node 版本太新,Ubuntu 太老
✅ 解决:
nvm install 18
nvm use 18
请贴出:
lsb_release -a
node -v
npm -v
如果你愿意,直接把报错内容复制过来,我一步一步帮你修 ✅