Debian Nodejs如何开启调试

在 Debian 上调试 Node.js，常见有 本地调试 和 远程调试 两种方式。下面按实用场景给你一个完整说明。

一、准备工作（Debian 上）

1. 安装 Node.js

推荐使用 NodeSource 或已打包版本：

# 查看是否已安装
node -v
npm -v

# 如果没有，可安装
sudo apt update
sudo apt install nodejs npm

建议 Node.js ≥ 14，调试体验更好。

二、使用 node inspect（内置调试器）

1. 启动调试模式

node inspect app.js

进入交互式调试界面：

debug>

常用命令：

• c / cont：继续执行
• n：下一步
• s：进入函数
• o：跳出函数
• repl：进入表达式求值
• quit：退出

三、使用 Chrome DevTools 调试（最推荐 ✅）

1. 启动 Node.js（开启调试端口）

node --inspect app.js

输出示例：

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

2. 在浏览器中打开调试界面

1. 打开 Chrome
2. 访问：

   chrome://inspect
   

3. 点击 Configure，确认包含：

   localhost:9229
   

4. 在 Remote Target 中点击你的 app.js

✅ 即可像调试前端一样使用断点、变量查看、调用栈等。

四、调试监听指定端口（常用于远程）

node --inspect=0.0.0.0:9229 app.js

适合：

• 服务器
• Docker
• WSL
• 远程 Debian 主机

五、调试已运行的 Node.js 进程

1. 查看进程 PID

ps aux | grep node

2. 发送信号开启调试

kill -USR1 <PID>

Node 会自动开启 --inspect。

六、使用 VS Code 调试（开发最常用 ✅）

1. 创建 .vscode/launch.json

{
  "version": "0.2.0",
  "configurations": [
    {
      "type": "node",
      "request": "launch",
      "name": "Debug Node",
      "program": "${workspaceFolder}/app.js"
    }
  ]
}

2. 按 F5 启动调试

支持：

• 断点
• 变量监视
• 调用栈
• 热重载（部分场景）

七、调试 npm 脚本

node --inspect node_modules/.bin/your-script

或：

npm run dev -- --inspect

（取决于脚本是否支持参数透传）

八、常见问题

❓ 9229 端口被占用

lsof -i :9229
kill -9 <PID>

❓ 远程无法连接

• 确保 --inspect=0.0.0.0
• 防火墙放行 9229

sudo ufw allow 9229

九、推荐方案总结

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

• 是 本地 Debian 桌面 还是 远程服务器
• 是否使用 Docker / PM2 / NestJS / Express

我可以给你更精确的调试配置。