如何调试 Node.js 应用程序？

以下是在不同环境下调试Node.js应用程序的方法：

一、使用Visual Studio Code（VS Code）调试Node.js应用程序

1. 安装Node.js运行时环境
   • 确保已经在本地安装了Node.js。可以从Node.js官方网站下载适合操作系统的安装包进行安装。
2. 创建调试配置文件
   • 在VS Code中打开Node.js项目。
   • 在项目根目录下创建一个名为.vscode的文件夹（如果不存在）。
   • 在.vscode文件夹中创建一个launch.json文件。可以通过点击VS Code的“调试”视图（左侧活动栏中的虫子图标），然后点击顶部的齿轮图标（配置或修复“launch.json”）来创建。
   • 在launch.json文件中，可以配置如下基本的调试设置：

     {
       "version": "0.2.0",
       "configurations": [
         {
           "type": "node",
           "request": "launch",
           "name": "Debug Node.js",
           "program": "${workspaceFolder}/app.js" // 根据实际的入口文件修改
         }
       ]
     }
     

3. 设置断点
   • 在Node.js代码中，点击行号左侧的空白区域来设置断点。例如，在JavaScript函数内部或者关键的代码行设置断点。
4. 启动调试
   • 在VS Code的“调试”视图中，选择配置好的“Debug Node.js”（或者根据自己的命名）调试配置，然后点击绿色的“启动调试”按钮（或者使用快捷键F5）。
   • VS Code会启动Node.js应用程序，并在遇到断点时暂停执行。
5. 调试操作
   • 查看变量：当程序暂停在断点处时，可以在“调试”视图的“变量”面板中查看当前作用域内的变量的值、类型等信息。
   • 单步调试：可以使用“调试”工具栏上的“单步执行（F10）”、“进入函数（F11）”、“跳出函数（Shift + F11）”等按钮来逐步执行代码并查看程序的执行流程。
   • 控制台输出：可以查看“调试控制台”中的输出信息，这对于查看日志或者检查程序执行过程中的输出非常有用。

二、使用命令行调试Node.js应用程序（使用Node.js内置的调试器）

1. 启动调试模式
   • 在命令行中，使用node --inspect app.js（如果是Windows系统，使用node --inspect -r ts - node/register app.ts对于TypeScript项目，这里假设使用了ts - node来运行TypeScript文件）来启动Node.js应用程序的调试模式。其中app.js是Node.js应用程序的入口文件，可以根据实际情况替换。
   • 这会启动一个调试服务器，并输出类似Debugger listening on ws://127.0.0.1:9229/...的信息，表示调试服务器正在监听指定端口。
2. 连接调试器
   • 在支持调试的浏览器（如Chrome）中，打开chrome://inspect页面。
   • 在“Remote Target”部分，点击“inspect”链接来连接到正在运行的Node.js调试服务器。
   • 此时会打开一个新的Chrome DevTools窗口，其中包含了Node.js应用程序的调试界面。
3. 调试操作
   • 在Chrome DevTools的“Sources”面板中，可以看到Node.js应用程序的代码。同样可以在代码中设置断点（点击行号左侧）。
   • 当Node.js应用程序执行到断点时，程序会暂停，就可以进行查看变量、单步调试等操作，操作方式类似于在Chrome浏览器中调试JavaScript代码。