Node.js 调试方法

Node.js 的三种常用调试方式及使用场景

问题

Node.js 有哪些调试方式?

解答

1. console.log() 调试

最简单的调试方式,直接在代码中输出变量和状态信息:

function calculateTotal(items) {
  console.log('items:', items);
  const total = items.reduce((sum, item) => sum + item.price, 0);
  console.log('total:', total);
  return total;
}

适合快速定位问题,但不适合复杂场景和性能分析。

2. Node.js 内置调试器

使用 --inspect--inspect-brk 启动调试:

# 启动时进入调试模式
node --inspect app.js

# 启动时在第一行暂停
node --inspect-brk app.js

然后在 Chrome 浏览器打开 chrome://inspect,连接到调试器进行断点调试、查看变量和堆栈信息。

3. 第三方调试工具

常用工具包括:

  • VS Code:内置调试功能,配置 .vscode/launch.json 即可使用
  • WebStorm:开箱即用的调试支持
  • ndb:Chrome DevTools 增强版调试工具

VS Code 调试配置示例:

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

关键点

  • console.log() 适合简单场景,无需配置但功能有限
  • 内置调试器需要配合 Chrome DevTools 使用,支持断点和变量查看
  • VS Code 和 WebStorm 等 IDE 提供更友好的调试体验
  • 复杂项目建议使用 IDE 调试工具,支持性能分析和堆栈跟踪