Ubuntu Nodejs 调试技巧有哪些

Ubuntu环境下Node.js调试常用技巧

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

Node.js自带的调试工具基于Chrome DevTools协议，无需额外安装。启动调试模式有两种方式：

• 基础调试：用node inspect app.js启动，会在代码第一行暂停，等待调试器连接；
• 断点调试：用node --inspect app.js启动，应用正常运行后，通过外部工具（如Chrome DevTools）连接调试。
  调试器支持设置断点、查看变量、单步执行（F10/F11）、查看调用堆栈等功能，适合精准定位代码问题。

2. 结合Visual Studio Code（VS Code）调试

VS Code是Node.js开发的常用编辑器，内置强大的调试功能：

• 打开项目后，点击左侧运行和调试图标（虫子+三角形）；
• 点击齿轮图标创建launch.json文件，选择“Node.js”环境，配置program指向入口文件（如${workspaceFolder}/app.js）；
• 在代码中点击行号左侧设置断点，点击绿色三角形启动调试，可实时查看变量值、调用堆栈及控制台输出。
  VS Code还支持Attach to Process（附加到进程），方便调试正在运行的Node.js应用。

3. 利用Chrome DevTools调试

若使用--inspect启动应用，可通过Chrome浏览器访问chrome://inspect页面：

• 在“Remote Target”部分找到你的Node.js进程（显示为应用名称或入口文件），点击inspect按钮；
• 打开Chrome DevTools的Sources面板，可直接调试代码（设置断点、查看变量、执行表达式），功能与VS Code类似但更熟悉。

4. 使用debug模块输出结构化日志

debug模块是轻量级调试工具，适合复杂项目的日志管理：

• 安装模块：npm install debug；
• 在代码中引入并定义命名空间：const debug = require('debug')('myapp:server')；
• 输出调试信息：debug('Server starting on port 3000')；
• 启用日志：通过环境变量DEBUG指定命名空间，如DEBUG=myapp:server node app.js，只会输出对应命名空间的日志。
  这种方式比console.log更灵活，可按模块/功能过滤日志，避免无关信息干扰。

5. 结合nodemon实现热重载调试

nodemon能监控文件变化并自动重启Node.js应用，配合调试工具可提升迭代效率：

• 全局安装nodemon：npm install -g nodemon；
• 用--inspect标志启动：nodemon --inspect app.js；
• 修改代码后，nodemon自动重启应用，调试器保持连接，无需手动重启。
  适合开发阶段频繁修改代码的场景，减少重复操作。

6. 第三方调试工具扩展

除内置工具外，可选择第三方工具增强调试能力：

• ndb：Chrome团队开发的Node.js调试器，基于Chrome DevTools，提供更现代的界面和高级功能（如内存分析），启动命令为ndb your_script.js；
• node-inspector：老牌调试工具，需通过npm install -g node-inspector安装，启动后生成调试页面，支持断点、变量查看等功能（适合习惯传统调试流程的用户）。

7. 基础日志调试（console.log/console.error）

对于快速诊断问题，console.log和console.error是最直接的方式：

• 用console.log输出变量值、函数调用信息（如console.log('User data:', user)）；
• 用console.error输出错误堆栈（如console.error('Error:', err.stack)）；
• 注意：生产环境应移除或替换为更专业的日志工具（如winston），避免泄露敏感信息。