ubuntu nodejs报错怎么办

在 Ubuntu 上运行 Node.js 报错，原因有很多种。下面我按常见错误类型 + 解决思路给你一个排查清单，你可以对照看看是哪一种。

一、常见报错 1：command not found: node

原因：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

二、常见报错 2：EACCES: permission denied

原因：全局安装包没权限。

错误示例

npm ERR! Error: EACCES: permission denied, access '/usr/lib/node_modules'

解决（推荐不滥用 sudo）

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

三、常见报错 3：Cannot find module 'xxx'

原因：依赖没装。

解决

rm -rf node_modules package-lock.json
npm install

如果是全局模块：

npm install -g xxx

四、常见报错 4：端口被占用

错误示例

Error: listen EADDRINUSE :::3000

解决

lsof -i:3000
kill -9 <PID>

或改端口：

app.listen(4000)

五、常见报错 5：Node 版本太低

错误示例

SyntaxError: Unexpected token '??'

解决 升级 Node：

node -v

建议 ≥ 18（LTS）

六、调试通用方法

1. 看完整报错（不要只看最后一行）
2. 用 npm ls 看依赖
3. 用 node app.js 而不是双击
4. 查看系统日志：

journalctl -u your-service

七、你可以这样告诉我，我能精准帮你

请把以下信息发我：

• 完整报错信息（复制粘贴）
• node -v
• npm -v
• Ubuntu 版本（lsb_release -a）
• 是前端 / 后端 / 脚本？

我可以一步一步帮你修。