使用 vscode 内置调试器可高效调试 node.js 应用。配置 launch.json文件,设置 name、program、cwd 等参数,选择“启动应用”或“附加到进程”模式,结合 –inspect 启动参数,支持断点调试、变量查看与单步执行,提升开发效率。

在开发 Node.js应用时,使用 VSCode 内置调试器能显著提升效率。无需额外安装 工具,只需简单配置即可实现断点调试、变量查看和单步执行。
启用 VSCode 调试功能
VSCode 自带调试支持,打开项目后点击左侧“运行和调试”图标(虫子标志),点击“创建 launch.json文件”开始配置。
选择环境为“node.js”,系统会自动生成基础 配置文件 。若未自动提示,可手动在项目根目录创建.vscode/launch.json 文件。
配置 launch.json 调试参数
编辑launch.json,常见配置如下:
{“version”: “0.2.0”, “configurations”: [ { “name”: “ 启动应用 ”, “type”: “node“, “request”: “launch”, “program”: “${workspaceFolder}/app.js”, “cwd”: “${workspaceFolder}”, “console”: “integratedTerminal”, “env”: {“NODE_ENV”: “development”} } ] }
说明:
- name:调试配置的名称,可自定义
- program:入口文件路径,如app.js、server.js 等
- cwd:工作目录,通常设为项目根目录
- console:设为 integratedTerminal 可在终端中输出日志
- env:设置 环境变量,便于区分开发与生产模式
附加到正在运行的进程
对于已启动的服务,可通过“附加”模式调试:
{“name”: “ 附加到进程 ”, “type”: “node”, “request”: “attach”, “port”: 9229, “restart”: true}
启动应用时需加上调试参数:
node –inspect app.js
或监听所有地址:
node –inspect=0.0.0.0:9229 app.js
这样就能在代码中设置断点并实时调试。
调试技巧与注意事项
确保文件保存后调试器能及时响应。若断点显示为灰色空心圆,表示未生效,检查文件路径是否正确或重启调试会话。
可在代码中手动插入 debugger; 语句,运行到此处会自动暂停。
利用“调试控制台”查看变量值、执行表达式,结合“调用 堆栈”面板分析函数调用流程。
基本上就这些。合理配置后,每次按 F5 即可快速启动调试会话,极大提升开发体验。


