Ubuntu上Node.js如何进行调试 - 问答

Ubuntu上Node.js调试方法汇总

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

内置调试器是Node.js原生支持的轻量级工具，无需额外安装软件，适合快速调试基础问题。

步骤1：添加断点
在需要暂停执行的代码行前插入debugger;语句（如函数入口、关键逻辑处），例如：
```
app.get('/', (req, res) => {
  debugger; // 此处暂停
  res.send('Hello World!');
});
```
步骤2：启动调试模式
终端运行命令node --inspect your_script.js（替换为实际文件名），启动后会显示调试服务器地址（如Debugger listening on ws://127.0.0.1:9229/...）。
步骤3：连接Chrome调试工具
打开Chrome浏览器，访问chrome://inspect，在“Remote Target”列表中找到你的Node.js应用，点击“inspect”打开开发者工具。
步骤4：调试操作
在开发者工具的“Sources”面板中，查看变量值、单步执行（F10/F11）、继续执行（F8）或重启调试（Ctrl+R）。

2. 使用Visual Studio Code（推荐）

VSCode是Node.js开发的常用IDE，内置强大的调试功能，支持断点、变量监视、调用栈分析等，适合复杂项目。

步骤1：安装VSCode
从官网下载并安装Ubuntu版VSCode。

步骤2：配置launch.json
打开项目文件夹，点击左侧“Run and Debug”图标（或按Ctrl+Shift+D），点击“create a launch.json file”，选择“Node.js”环境。修改生成的配置文件，指定项目路径：

{
  "version": "0.2.0",
  "configurations": [
    {
      "type": "node",
      "request": "launch",
      "name": "Launch Program",
      "program": "${workspaceFolder}/your_script.js" // 替换为实际文件名
    }
  ]
}

步骤3：添加断点
在代码行号左侧点击，添加红色断点（如路由处理函数、业务逻辑入口）。
步骤4：启动调试
按F5或点击“Run and Debug”面板的绿色三角形按钮，VSCode会启动Node.js应用并在断点处暂停。此时可查看变量值、调用栈、监视表达式等。

3. 使用Node-Inspect CLI（进阶）

node-inspect是Node.js官方推荐的命令行调试工具，适合习惯终端操作的用户，支持异步栈跟踪等高级特性。

步骤1：全局安装
终端运行npm install -g node-inspect安装工具。
步骤2：启动调试
运行node-inspect your_script.js，终端会进入调试模式，显示debug>提示符。
步骤3：调试命令
使用以下命令控制调试流程：
- cont（或c）：继续执行到下一个断点；
- next（或n）：单步执行（跳过函数）；
- step（或s）：单步进入函数；
- out（或o）：单步跳出函数；
- repl：进入REPL模式，查看/修改变量值。

4. 使用Chrome DevTools直接调试

通过Chrome浏览器的DevTools调试Node.js，适合需要熟悉浏览器调试界面的用户。

步骤1：启动调试模式
终端运行node --inspect-brk your_script.js（--inspect-brk会在第一行暂停，方便初始调试）。
步骤2：打开DevTools
浏览器访问chrome://inspect，找到你的应用并点击“inspect”。
步骤3：调试操作
在“Sources”面板中，通过断点、单步执行等功能调试代码，支持查看DOM、网络请求等（若应用涉及前端交互）。

注意事项

调试时建议关闭生产环境代码中的debugger语句，避免影响正常运行；
对于大型项目，使用VSCode的launch.json配置可简化重复操作；
异步代码调试时，内置调试器和VSCode能更好地跟踪调用栈，比console.log更高效。

0 赞

0 踩