在 Linux 下运行 JavaScript(Node.js 或浏览器环境)报错,排查思路和 Windows / macOS 基本一致,但有一些 Linux 特有注意点。下面按常见场景 + 解决步骤给你讲。
node xxx.js)最常见错误类型:
Cannot find module)EACCES)EADDRINUSE)Cannot find module 'xxx'Error: Cannot find module 'express'
解决:
npm install
# 或
npm install express
如果是全局模块:
npm root -g
EACCESError: EACCES: permission denied
不要直接用 sudo(不推荐) 推荐方式:
npm config set prefix ~/.npm
export PATH=~/.npm/bin:$PATH
或:
sudo chown -R $USER ~/.npm
EADDRINUSEError: listen EADDRINUSE :::3000
查看占用:
lsof -i:3000
# 或
netstat -tunlp | grep 3000
结束进程:
kill -9 PID
SyntaxError: Unexpected token
查看版本:
node -v
升级(示例 Ubuntu):
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs
import App from './App.js'
// 实际文件是 app.js ❌
✅ Linux 严格区分大小写
/ 不是 \'./data\\config.json' ❌
'./data/config.json' ✅
bash: ./run.js: Permission denied
解决:
chmod +x run.js
try {
// 代码
} catch (err) {
console.error(err.stack)
}
node --inspect app.js
如果你愿意,可以把具体报错内容贴出来,例如:
我可以直接帮你精准定位并给解决方案。
你现在是遇到哪一种报错?