Debian 上 NodeJS 如何调试

在 Debian 上调试 Node.js 有多种方式，下面按常用程度和场景给你一个清晰指南。

一、最基础：用 node 自带调试器

1️⃣ 命令行调试（简单但不直观）

node inspect app.js

或（旧写法）

node debug app.js

浏览器打开：

chrome://inspect

适合：

• 服务器无 GUI
• 快速查看调用栈

二、推荐方式：Chrome DevTools 远程调试（最常用）

1️⃣ 启动 Node 调试模式

node --inspect app.js

或监听断点启动：

node --inspect-brk app.js

输出示例：

Debugger listening on ws://127.0.0.1:9229/...

2️⃣ 在 Chrome 中调试

打开：

chrome://inspect

点击 Open dedicated DevTools for Node

✅ 支持：

• 断点
• 变量查看
• 调用栈
• 单步执行

三、Debian 无桌面？用 SSH + 端口转发

1️⃣ 服务器启动

node --inspect=0.0.0.0:9229 app.js

2️⃣ 本地端口转发

ssh -L 9229:localhost:9229 user@server

本地浏览器：

chrome://inspect

⚠️ 安全提示：

• 不要长期暴露 9229 端口
• 可用防火墙限制

四、VS Code 调试（开发者最推荐）

1️⃣ 本地调试

launch.json：

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

2️⃣ 远程调试（Debian 服务器）

服务器：

node --inspect-brk app.js

VS Code：

{
  "type": "node",
  "request": "attach",
  "name": "Remote",
  "port": 9229,
  "host": "localhost"
}

配合 SSH 端口转发使用。

五、日志 & 运行时调试（轻量）

1️⃣ 内置

console.log()
console.error()

2️⃣ 高级

node --trace-warnings app.js
node --stack-trace-limit=100 app.js

六、常见问题

❓ Debian 上 node 命令不存在？

which node
node -v

若没有：

sudo apt install nodejs npm

或装官方版本（推荐）：

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

七、总结建议

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

• 是 本地还是服务器
• 用 VS Code / 终端 / WebStorm
• 是 Express / Nest / 原生 Node

我可以给你更精确的配置示例。