在 Node.js 中调试代码是开发过程中非常重要的一部分。以下是几种常见的调试方法，涵盖了从简单到高级的工具和技巧：

一、常见方案

1、使用 console.log

这是最简单的调试方法，通过打印变量或状态信息来检查代码执行情况。

1.1、示例：

function add(a, b) {
  console.log("a:", a, "b:", b); // 打印输入参数
  return a + b;
}

const result = add(2, 3);
console.log("Result:", result); // 打印结果

1.2、优点：

• 简单直接，无需额外工具。
• 适合快速检查变量值或流程。

1.3、缺点：

• 需要手动添加和删除 console.log。
• 不适合复杂调试场景。

2、使用 Node.js 内置调试器

Node.js 内置了一个简单的调试器，可以通过 node inspect 启动。

2.1、步骤

1. 在代码中添加 debugger 语句。
2. 使用 node inspect 运行脚本。

2.2、示例

function add(a, b) {
  debugger; // 断点
  return a + b;
}

const result = add(2, 3);
console.log("Result:", result);

2.3、运行

node inspect script.js

2.4、调试命令

• cont 或 c：继续执行。
• next 或 n：执行下一行。
• step 或 s：进入函数。
• out 或 o：跳出函数。
• repl：进入交互式 REPL 模式。

2.5、优点

• 无需安装额外工具。
• 适合简单的调试场景。

2.6、缺点

• 功能有限，不如图形化工具方便。

3、使用 Chrome DevTools

Node.js 支持通过 Chrome DevTools 进行调试，提供了图形化界面和强大的调试功能。

3.1、步骤：

1. 使用 --inspect 或 --inspect-brk 启动 Node.js 脚本：

   node --inspect script.js

   • --inspect：启动调试器，代码立即执行。
   • --inspect-brk：启动调试器，代码在首行暂停。

2. 打开 Chrome 浏览器，访问 chrome://inspect。

3. 在 "Remote Target" 中找到你的脚本，点击 "Inspect"。

3.2、功能

• 设置断点。
• 查看变量和调用栈。
• 实时修改代码。
• 性能分析。

3.3、优点

• 图形化界面，易于使用。
• 功能强大，适合复杂调试。

3.4、缺点

• 需要 Chrome 浏览器。

4、使用 VS Code 调试

VS Code 是流行的代码编辑器，内置了强大的 Node.js 调试工具。

4.1、步骤

1. 打开 VS Code，打开你的项目。
2. 在代码中设置断点（点击行号左侧）。
3. 点击左侧的调试图标（或按 Ctrl+Shift+D），然后点击 "Run and Debug"。
4. 选择 "Node.js" 环境。

4.2、调试功能

• 设置断点。
• 查看变量、调用栈和作用域。
• 逐步执行代码（Step Over、Step Into、Step Out）。
• 调试控制台。

4.3、优点

• 集成在编辑器中，无需切换工具。
• 支持高级调试功能。

4.3、缺点

• 需要安装 VS Code。

5、使用 ndb

ndb 是 Google 推出的 Node.js 调试工具，基于 Chrome DevTools，提供了更好的调试体验。

5.1、安装

npm install -g ndb

5.2、使用

ndb script.js

5.3、优点

• 专为 Node.js 设计，功能强大。
• 支持 Chrome DevTools 的所有功能。

5.4、缺点

• 需要额外安装。

6、使用日志库（如 debug）

对于复杂的应用程序，可以使用日志库（如 debug）来记录调试信息。

6.1、安装

npm install debug

6.2、示例

const debug = require("debug")("app");

function add(a, b) {
  debug("Adding %d and %d", a, b);
  return a + b;
}

const result = add(2, 3);
debug("Result:", result);

6.3、启用调试

DEBUG=app node script.js

6.4、优点

• 可以按模块或功能启用/禁用调试信息。
• 适合大型项目。

6.5、缺点

• 需要手动添加日志语句。

二、总结

调试方法	优点	缺点	适用场景
console.log	简单直接	手动添加/删除，不适合复杂场景	快速检查变量或流程
Node.js 内置调试器	无需额外工具	功能有限	简单的调试场景
Chrome DevTools	图形化界面，功能强大	需要 Chrome 浏览器	复杂调试场景
VS Code 调试	集成在编辑器中，功能强大	需要安装 VS Code	开发中的日常调试
ndb	专为 Node.js 设计，功能强大	需要额外安装	需要高级调试功能的场景
日志库（如 debug）	按需启用/禁用调试信息，适合大型项目	需要手动添加日志语句	大型项目的调试和日志记录

根据项目需求和个人偏好选择合适的调试方法。对于大多数开发者，VS Code 调试 和 Chrome DevTools 是最推荐的工具。

更新日志

2025/8/24 08:17

查看所有更新日志

• e7112-1于 2025/8/24