在Debian上Node.js如何进行调试

在Debian环境下调试Node.js，方法其实挺多的。从最基本的命令行工具，到图形化的IDE集成，再到轻量级的日志模块，覆盖的场景和需求各不相同。下面逐一拆解，看看哪种更适合你的实际工作流。

在Debian上调试Node.js的常用方法

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

Node.js 自带的 node inspect 命令，一个终端就能搞定全部操作。设置断点、单步执行、查看变量，都不需要额外安装任何工具。

• 启动调试：终端里直接跑 node inspect yourScript.js（换成你的脚本路径就行）。

• 设置断点：在源码中写上 debugger;，程序执行到这行时会自动停下，相当于埋了一个断点标记。

• 调试命令方面，常用的几个得记一下：

  • c：继续跑，直到下一个断点；
  • n：执行下一行，但不深入函数内部；
  • s：进入函数内部；
  • o：跳出当前函数；
  • repl：进入交互式 REPL 模式，可以随时查看甚至修改变量值。

  这种方法对命令行操作熟练的开发者来说很友好，省去了图形界面切换的成本。

2. 使用Chrome DevTools调试

如果你习惯浏览器的调试界面，Chrome DevTools 也能直接连上 Node.js 进程。过程很简单：

• 启动调试模式时，运行 node --inspect yourScript.js。如果需要从第一行就开始暂停，用 --inspect-brk 即可。
• 连接操作：打开 Chrome，访问 chrome://inspect，点击“Open dedicated DevTools for Node”链接，就能看到 Node 进程挂上来了。
• 后续操作和前端调试没有区别：在“Sources”面板里设断点、查看调用栈、监视变量、单步执行，该有的功能一个不少。

3. 使用Visual Studio Code（VSCode）调试

VSCode 内置的 Node.js 调试支持，可以说是目前最主流的方案。配置一次就能反复使用，适合绝大多数项目。

• 配置 launch.json 的步骤：
  1. 打开项目，点击左侧“Run and Debug”图标（或者按 Ctrl+Shift+D）；
  2. 点击“Create a launch.json file”，选择“Node.js”环境；
  3. 按照需要修改配置，一个典型的配置模板是这样的：

  {
    "version": "0.2.0",
    "configurations": [
      {
        "type": "node",
        "request": "launch",
        "name": "Launch Program",
        "program": "${workspaceFolder}/yourScript.js",
        "skipFiles": ["/**"]
      }
    ]
  }
  

• 启动调试：按 F5 或者点那个绿色的“Start Debugging”按钮，VSCode 就会自动启动应用并挂上调试器。
• 支持断点、条件断点、变量监视、调用栈查看、调试控制台，操作非常直观。

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

debug 模块是 Node.js 生态里使用很广的日志调试工具。它的核心价值在于通过命名空间来控制哪些日志输出，避免大项目中日志满天飞。

• 安装方式：直接 npm install debug。
• 代码中使用：

const debug = require('debug')('myapp:server');
debug('Server started at %s', new Date());

• 启用调试时，在终端设置 DEBUG 环境变量，比如 DEBUG=myapp:server node yourScript.js，这样只有 myapp:server 命名空间的日志会被输出。
• 这种方式的优势很明显：通过环境变量动态开关调试信息，开发环境可以开得细一点，生产环境可以关掉或者只保留关键模块的日志，排查问题很方便。

5. 使用第三方调试工具（如node-debug）

还有一个工具叫 node-debug，它基于 Chrome DevTools，但做了进一步封装，简化了连接流程。对于不熟悉命令行或者刚入门的开发者来说，可以省去不少配置时间。

• 安装：npm install -g node-debug。
• 启动调试：终端里运行 node-debug yourScript.js，它会自动打开 Chrome 浏览器并加载调试界面，支持断点、单步执行、变量查看等功能。

上面这几种方法从命令行到图形化，覆盖了不同的调试习惯和项目复杂度。简单场景下用 console.log 或者 debug 模块足够；复杂项目首选 VSCode 或者 Chrome DevTools；团队协作时，配置好的 VSCode 调试配置文件是最省心的选择。根据实际需求挑一个顺手的就行。