VSCode调试：Node.js应用调试指南

首先配置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": [
        "<node_internals>/**"
      ],
      "env": {
        "NODE_ENV": "development"
      }
    }
  ]
}

说明：

• program 指向入口文件（如app.js或server.js）
• env 可设置运行环境变量
• skipFiles 避免进入Node.js内部代码

开始调试与常用操作

点击VSCode左侧调试图标，选择“调试Node.js应用”，然后按F5启动。

常用功能包括：

• 在代码行号左侧点击红点添加断点
• 调试控制栏支持继续、单步跳过、单步进入、跳出等操作
• 左侧变量面板实时显示作用域内的变量值
• 调试控制台可执行当前上下文的JavaScript表达式

若使用Express等框架，断点仍能正常触发，便于检查请求处理逻辑。

白瓜面试

白瓜面试 - AI面试助手,辅助笔试面试神器

40

查看详情

附加到正在运行的Node进程

适用于无法直接启动的应用（如npm scripts启动的服务）。

修改package.json脚本：

<code>"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参数。

以上就是VSCode调试：Node.js应用调试指南的详细内容，更多请关注php中文网其它相关文章！