debian nodejs怎么调试

debian

小樊

2026-10-05 07:25:08

栏目: 编程语言

在 Debian 上调试 Node.js，常见方式有以下几种，按使用频率和实用性给你一个清晰清单。

一、最基础：日志调试（不推荐长期用）

console.log('value =', value);

适合临时排查，不适合复杂问题。

二、使用 Node.js 内置调试器（命令行）

1️⃣ 启动调试模式

node inspect app.js

或旧写法：

node --debug-brk app.js

2️⃣ 常用调试命令

cont / c     继续执行
next / n     单步
step / s     进入函数
out / o      跳出函数
repl         进入交互环境

适合无 GUI 服务器环境。

三、VS Code 远程 / 本地调试（强烈推荐 ✅）

方式 A：本地调试（Debian 桌面）

安装 VS Code
创建 .vscode/launch.json

{
  "type": "node",
  "request": "launch",
  "name": "Debug Node",
  "program": "${workspaceFolder}/app.js"
}

打断点 → F5

方式 B：远程调试（服务器无界面）

1️⃣ 启动 Node

node --inspect=0.0.0.0:9229 app.js

2️⃣ 防火墙放行

sudo ufw allow 9229

3️⃣ VS Code 配置

{
  "type": "node",
  "request": "attach",
  "name": "Remote Debug",
  "address": "服务器IP",
  "port": 9229
}

四、Chrome 浏览器调试（最直观 ✅）

node --inspect app.js

打开：

chrome://inspect

点击 Remote Target → inspect

适合前端 + Node 混合调试。

五、生产环境调试（⚠️ 谨慎）

node --inspect-brk app.js

⚠️ 不要长期开 --inspect，有安全风险

六、常见问题（Debian 特有）

❓ node 命令不存在

which node
sudo apt install nodejs npm

或：

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

七、推荐组合

✅ 开发：VS Code + --inspect
✅ 服务器：VS Code Remote + SSH
✅ 紧急排查：node inspect

如果你愿意，可以告诉我：

是 本地还是服务器
是否用 Docker
是 Express / Nest / 原生 Node

我可以给你精准配置示例。