首先配置launch.json文件,然后在vscode中设置断点并启动调试,即可实现node.js应用的断点调试、变量查看与控制台输出。

在VSCode中调试Node.js应用非常方便,只需简单配置即可实现断点调试、变量查看和控制台输出等功能。以下是具体操作步骤。
启用调试功能
VSCode内置了对node.js调试的支持,无需安装额外插件(除非你使用旧版本)。确保你已安装Node.js并能通过命令行运行node --version验证环境正常。
打开你的Node.js项目文件夹,在左侧活动栏点击“调试图标”(虫子形状),然后点击顶部的“运行和调试”按钮。如果这是第一次调试,VSCode会提示你选择环境,选择“Node.js”即可。
创建 launch.json 配置文件
VSCode会自动生成一个.vscode/launch.json文件,用于定义调试配置。常见配置如下:
{ “version”: “0.2.0”, “configurations”: [ { “type”: “node“, “request”: “launch”, “name”: “调试 Node.js 应用”, “program”: “${workspaceFolder}/app.js”, “cwd”: “${workspaceFolder}”, “console”: “integratedTerminal”, “env”: { “NODE_ENV”: “development” } } ] }
说明:
- type: 使用”node”调试器
- request: “launch”表示启动应用,”attach”用于附加到已运行进程
-  program: 入口文件路径,如app.js或index.js
- cwd: 工作目录,通常为项目根目录
- console: 推荐设为”integratedTerminal”以便在终端中看到输出
- env: 可设置环境变量
开始调试
在代码中点击行号左侧添加断点(红点),然后回到调试视图,选择刚才配置的调试项并点击“启动调试”按钮(F5)。
程序会在断点处暂停,此时你可以:
如果你的应用是通过npm start启动的,也可以修改launch.json使用以下配置:
{ “type”: “node”, “request”: “launch”, “name”: “通过 npm 启动调试”, “runtimeExecutable”: “npm”, “runtimeArgs”: [“run”, “start”], “cwd”: “${workspaceFolder}”, “console”: “integratedTerminal” }
附加到正在运行的进程
如果你想调试一个已经运行的Node.js服务(例如用node app.js启动的),可以使用“attach”模式:
{ “type”: “node”, “request”: “attach”, “name”: “附加到进程”, “port”: 9229 }
先以调试模式启动应用:
node –inspect app.js
或监听特定端口:
node –inspect=9229 app.js
然后在VSCode中选择“附加到进程”配置并启动调试。
基本上就这些。配置一次后,以后调试只需按F5。关键是launch.json要指向正确的入口文件。遇到问题检查文件路径和Node版本兼容性。调试是提升开发效率的重要手段,熟练掌握很有帮助。


