首先配置 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 版本兼容性。调试是提升开发效率的重要手段,熟练掌握很有帮助。


