“Debian 上 Node.js 报错”这个范围很广,不同错误原因完全不同。下面我按最常见的情况给你一个排查 + 解决清单,你可以对照看是哪一类。
在终端执行:
node -v
npm -v
which node
cat /etc/os-release
把完整报错信息贴出来,更准确。
command not found: node原因:没装或装错方式
✅ 正确安装(推荐):
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs
或:
sudo apt install nodejs npm
⚠️ Debian 自带版本可能很旧,不建议生产用。
E: Unable to locate package nodejs原因:软件源没更新或未加 NodeSource
解决:
sudo apt update
还是不行就加 NodeSource(见上)
npm ERR! code EACCES原因:权限不足
❌ 不要 sudo npm -g
✅ 正确做法:
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
node: /lib/x86_64-linux-gnu/libc.so.6: version GLIBC_2.xx not found原因:系统太老(如 Debian 9)
解决:
docker run -it node:20
lsof -i:3000
kill -9 PID
rm -rf node_modules package-lock.json
npm install
请把以下信息发我:
node -v 和 cat /etc/os-release我可以一步到位给你方案。