首先配置launch.json文件,然后在VSCode中设置断点并启动调试。通过program指定入口文件,env设置环境变量,使用attach模式附加到运行中的Node进程,结合控制台和变量面板可高效排查问题。

调试Node.js应用时,VSCode提供了强大且直观的工具支持。你不需要依赖外部调试器,只需正确配置启动参数,就能在编辑器中设置断点、查看变量、单步执行代码。关键在于理解launch.json配置和Node.js调试模式的工作机制。
启用调试前的准备工作
确保你的开发环境中已安装:
- Node.js(建议LTS版本)
- VSCode编辑器
- VSCode中的“Node.js Extension Pack”(可选但推荐)
确认Node.js可用:在终端运行node --version,如果返回版本号说明环境正常。
创建调试配置文件 launch.json
VSCode通过.vscode/launch.json定义调试行为。在项目根目录下创建该文件,内容如下:
{
"version": "0.2.0",
"configurations": [
{
"type": "node",
"request": "launch",
"name": "调试Node.js应用",
"program": "${workspaceFolder}/app.js",
"outFiles": [
"${workspaceFolder}/**/*.js"
],
"skipFiles": [
"/**"
],
"env": {
"NODE_ENV": "development"
}
}
]
}
说明:
开始调试与常用操作
点击VSCode左侧调试图标,选择“调试Node.js应用”,然后按F5启动。
常用功能包括:
- 在代码行号左侧点击红点添加断点
- 调试控制栏支持继续、单步跳过、单步进入、跳出等操作
- 左侧变量面板实时显示作用域内的变量值
- 调试控制台可执行当前上下文的JavaScript表达式
若使用Express等框架,断点仍能正常触发,便于检查请求处理逻辑。
本文档主要讲述的是Flash Builder操作指南;Flash Builder将构成应用程序的资源(文件夹和文件)组合到一个容器中,我们将其称为项目。项目包含一组属性,这些属性控制应用程序的构建方式、构建的应用程序所在的位置、调试的处理方式以及该项目于工作空间中其他项目的关系。希望本文档会给有需要的朋友带来帮助;感兴趣的朋友可以过来看看
附加到正在运行的Node进程
适用于无法直接启动的应用(如npm scripts启动的服务)。
修改package.json脚本:
"scripts": {
"dev": "node --inspect-brk app.js"
}
运行npm run dev,Node会暂停并等待调试器连接。
在VSCode中使用以下配置附加:
{
"type": "node",
"request": "attach",
"name": "附加到Node进程",
"port": 9229,
"restart": true
}
启动该配置后,即可连接到正在运行的进程进行调试。
基本上就这些。合理配置launch.json,结合断点与控制台,大部分运行时问题都能快速定位。调试并不复杂,但容易忽略细节比如入口文件路径或inspect参数。









