Node.js在Debian上的调试技巧

Node.js在Debian上的调试技巧

1. 使用内置调试器（node inspect）

Node.js内置了基于V8 Inspector协议的调试器，可通过命令行快速启动调试模式。启动时添加--inspect（允许应用正常启动后附加调试器）或--inspect-brk（启动时暂停在第一行，便于从开头调试）标志，例如：
node --inspect-brk app.js
这会在默认端口9229上启动调试服务器，输出类似Debugger listening on ws://127.0.0.1:9229/xxxxxx的信息。

2. 结合Chrome DevTools可视化调试

Chrome浏览器的DevTools提供了图形化调试界面，适合直观查看变量、调用栈和DOM（若涉及前端渲染）。操作步骤：

启动Node.js应用后，打开Chrome并访问chrome://inspect；
在“Remote Target”列表中找到你的应用（如node://app.js），点击“inspect”；
在DevTools的“Sources”标签页中，可设置断点、单步执行（F10/F11）、查看变量值，还能通过“Pause on exceptions”按钮捕获未处理的异常。

3. 用Visual Studio Code（VS Code）高效调试

VS Code是Node.js开发的常用IDE，内置调试功能且配置简单。步骤如下：

打开项目，点击左侧“运行和调试”图标（或按Ctrl+Shift+D）；
点击“创建launch.json文件”，选择“Node.js”环境；

修改配置（以启动本地应用为例）：

{
  "version": "0.2.0",
  "configurations": [
    {
      "type": "node",
      "request": "launch",
      "name": "Launch Program",
      "program": "${workspaceFolder}/app.js",
      "skipFiles": ["<node_internals>/**"] // 忽略Node.js内部文件
    }
  ]
}

保存后按F5启动调试，VS Code会自动附加到Node.js进程，支持断点、变量监视、调用栈分析等功能。

4. 使用debug包进行模块化调试

debug包是轻量级的日志调试工具，适合模块化应用（如Express、Koa）。安装后，通过命名空间区分不同模块的日志：

安装：npm install debug；
代码中使用：const debug = require('debug')('myapp:server'); debug('Server started')；
动态开启调试：通过DEBUG环境变量指定命名空间，例如DEBUG=myapp:server node app.js，只会输出myapp:server前缀的日志。还可通过DEBUG_COLORS=true开启彩色输出，提升可读性。

5. 利用nodemon实现热重载调试

nodemon能监控文件变化并自动重启应用，避免频繁手动重启，提升开发效率。安装全局工具：npm install -g nodemon；

基本调试：nodemon --inspect app.js（自动重启并开启调试模式）；

配置文件：创建nodemon.json指定监控目录和调试命令：

{
  "watch": ["src"], // 监控src目录
  "exec": "node --inspect-brk src/app.js" // 启动时暂停在第一行
}

启动：nodemon，修改代码后会自动重启并保持调试状态。

6. 通过日志输出快速定位问题

console.log()是最基础的调试方法，适合快速输出变量值或流程信息。进阶用法：

使用模板字符串输出对象：console.log('User data:', JSON.stringify(user, null, 2))（格式化JSON）；
结合util.inspect输出复杂对象：const util = require('util'); console.log(util.inspect(obj, {depth: null}))（显示对象完整结构）；
通过NODE_ENV环境变量控制日志级别（如开发环境输出详细日志，生产环境关闭）：NODE_ENV=development node app.js。

7. 使用PM2管理生产环境调试

PM2是Node.js生产环境进程管理工具，支持调试模式和日志管理。安装：sudo npm install pm2 -g；

启动调试：pm2 start app.js --inspect（开启调试模式）；
查看日志：pm2 logs（实时输出应用日志），pm2 logs app --lines 100（查看最近100行）；
调试时，可通过pm2 attach app连接到进程，或通过--inspect端口配合Chrome DevTools调试。