怎样调试 nodejs程序？

封面图 • 2025-11-22 • nodejs

调试 Node.js 程序是开发过程中非常重要的一环，可以帮助你快速定位和修复代码中的问题。以下是几种常用的调试方法：

---

## 一、使用 `console.log()`（最基础）

虽然简单，但非常实用。

```javascript
console.log('当前变量值:', variable);
```

**优点**：简单易用，适合快速查看变量状态或程序流程。

**缺点**：不够精细，不能设置断点、查看调用栈等。

---

## 二、使用内置的 `inspect` 模块（Node.js 内置调试器）

Node.js 提供了内置的调试器，可以通过命令行启动。

### 1. 在代码中添加 `debugger;` 语句

```javascript
function example() {
  let a = 1;
  debugger; // 运行到这里会暂停
  console.log(a);
}
```

### 2. 启动调试模式

```bash
node inspect yourfile.js
```

或者在代码中加入：

```bash
node --inspect-brk yourfile.js
```

> 注意：`--inspect-brk` 会在程序启动时暂停，方便调试入口。

---

## 三、使用 VS Code 调试器（推荐）

VS Code 是一个非常强大的编辑器，支持 Node.js 的调试功能。

### 步骤：

1. 打开你的 Node.js 项目。
2. 在 `.vscode/launch.json` 中配置调试器（如果没有就创建）：

```json
{
  "version": "0.2.0",
  "configurations": [
    {
      "type": "node",
      "request": "launch",
      "name": "Debug Node.js",
      "runtimeArgs": ["--inspect-brk", "${workspaceFolder}/index.js"],
      "console": "integratedTerminal",
      "internalConsoleOptions": "neverOpen"
    }
  ]
}
```

3. 在代码中添加断点（点击行号左侧），然后点击“开始调试”按钮（绿色箭头）。

---

## 四、使用 Chrome DevTools 调试

Node.js 支持通过 Chrome DevTools 进行调试。

### 步骤：

1. 启动 Node.js 并开启调试端口：

```bash
node --inspect-brk yourfile.js
```

2. 打开 Chrome 浏览器，访问：

```
http://localhost:9229
```

3. 在 DevTools 中选择你的 Node.js 进程，就可以进行调试了。

---

## 五、使用 `nodemon` + 调试

如果你正在使用 `nodemon` 来监视文件变化并重启服务器，可以这样配合调试：

```bash
nodemon --inspect-brk yourfile.js
```

---

## 六、使用第三方调试工具

- **Node-Inspector**：旧版调试工具，现在基本被内置调试器替代。
- **Visual Studio Code**：推荐使用。
- **WebStorm / IntelliJ IDEA**：也支持 Node.js 调试。

---

## 七、使用日志库（如 `winston`, `log4js`）

对于生产环境或复杂应用，建议使用日志库来记录运行信息，而不是 `console.log()`。

```bash
npm install winston
```

```javascript
const winston = require('winston');

winston.level = 'debug';

winston.debug('This is a debug message');
winston.info('This is an info message');
winston.error('This is an error message');
```

---

## 八、使用 `assert` 模块做断言检查

```javascript
const assert = require('assert');

assert.strictEqual(1 + 1, 2, '1 + 1 should equal 2');
```

如果断言失败，会抛出错误。

---

## 九、使用 `process.on('uncaughtException')` 捕获异常

```javascript
process.on('uncaughtException', (err) => {
  console.error('Uncaught exception:', err);
});
```

---

## 十、使用 `try...catch` 捕获错误

```javascript
try {
  // 可能出错的代码
} catch (err) {
  console.error('Caught error:', err);
}
```

---

## 总结

| 方法 | 适用场景 | 优点 |
|------|----------|------|
| `console.log()` | 快速查看变量 | 简单快捷 |
| `debugger;` + `node inspect` | 基础调试 | 不需要额外工具 |
| VS Code 调试 | 高级调试 | 功能强大，支持断点、变量查看等 |
| Chrome DevTools | Web 开发者友好 | 熟悉浏览器调试的人容易上手 |
| 日志库（如 `winston`） | 生产环境 | 更规范、可维护 |
| `assert` 和 `try...catch` | 错误检查 | 有助于发现逻辑错误 |

---

如果你告诉我你使用的具体环境（如 VS Code、终端、IDE 等），我可以给出更具体的调试方式。