Node.js 怎么用 --inspect 和 Chrome DevTools 远程调试？

Question

仓乃文 · Accepted Answer

console.log 调试效率低，无法实时查看变量、设断点、单步执行。Node.js 内置 V8 Inspector，启动时加 --inspect 标志即可用 Chrome DevTools 远程调试，支持断点、单步、变量查看、CPU 和内存分析。

启动调试模式：
```bash
node --inspect app.js
# 或启动后立即暂停等待调试器连接
node --inspect-brk app.js
# 指定端口和地址（远程服务器调试）
node --inspect=0.0.0.0:9229 app.js
```

Chrome DevTools 连接：
```
1. 打开 Chrome，访问 chrome://inspect
2. 点击 "Configure..." 添加目标服务器地址和端口
3. 在 Remote Target 列表中点击 "inspect"
4. 打开 Sources 面板设断点、查看变量
```

VS Code 调试配置：
```json
{
  "type": "node",
  "request": "attach",
  "name": "Attach Remote",
  "address": "localhost",
  "port": 9229,
  "localRoot": "${workspaceFolder}",
  "remoteRoot": "/app"
}
```

补充说明：
- --inspect-brk 在第一行代码处暂停，适合调试启动阶段问题
- 生产环境调试不要暴露 9229 端口到公网，有安全风险
- 可以用 SSH 隧道转发：ssh -L 9229:localhost:9229 user@server
- Memory 面板可以抓取堆快照分析内存泄漏
- Performance 面板可以录制 CPU Profile 分析性能瓶颈