VSCode调试Node.js应用的详细步骤全解析

VSCode调试Node.js应用无需额外插件，只需配置launch.json并打开项目文件夹。自动生成配置后设断点，按F5启动即可完成启动、断点、单步等全流程调试。

在 VSCode 中调试 Node.js 应用其实很直接，关键在于配置好 launch.json 并理解运行时行为。不需要额外安装插件（Node.js 扩展已内置），也不用命令行加 --inspect 手动启停——VSCode 能自动完成启动、断点、单步、变量查看等全流程。

确认环境和基础准备

确保你已安装：

• Node.js（v14+ 推荐，支持 ES 模块和现代调试协议）
• VSCode（最新稳定版，自带 Node Debug Adapter）
• 项目根目录下有 package.json（非必须但强烈建议）

打开项目文件夹（不是单个文件），这是 VSCode 识别工作区和生成调试配置的前提。

自动生成 launch.json 配置

按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS），输入 “Debug: Open launch.json”，回车。

如果首次配置，VSCode 会提示选择环境，选 Node.js；接着选启动方式：

• “Node.js: Launch Program”：调试本地 JS 文件（如 index.js 或 app.js）
• “Node.js: Attach to Process”：连接已运行的 Node 进程（适合调试 pm2、cluster 等场景）
• “Node.js: NPM Script”：直接运行 npm start 或自定义 script（需 package.json 中已定义）

选完后，VSCode 自动生成 .vscode/launch.json，例如最常用的启动配置：

Pebblely

AI产品图精美背景添加

96

查看详情

{
  "version": "0.2.0",
  "configurations": [
    {
      "type": "node",
      "request": "launch",
      "name": "Launch index.js",
      "skipFiles": ["<node_internals>/**"],
      "program": "${workspaceFolder}/index.js",
      "console": "integratedTerminal",
      "internalConsoleOptions": "neverOpen"
    }
  ]
}

设置断点与启动调试

在代码行号左侧灰色区域单击，出现红点即为断点。支持：

• 普通断点（点击行号旁空白处）
• 条件断点（右键红点 → “Edit Breakpoint” → 输入 JS 表达式，如 count > 5）
• 日志点（右键 → “Add Log Point”，输入要打印的内容，不中断执行）

按 F5 启动调试，或点击左侧调试图标 → 选择配置名 → 点击绿色三角。VSCode 会自动：

• 启动 Node 进程（带 --inspect 参数）
• 附加调试器
• 在第一个断点暂停，并高亮当前行

调试过程中的核心操作

调试启动后，顶部会出现控制栏（继续、跳过、步入、步出、重启、停止）：

• F10：跳过（Step Over），执行当前行，不进入函数内部
• F11：步入（Step Into），进入函数内部（包括 node_modules 中的代码，可配合 skipFiles 过滤）
• Shift+F11：步出（Step Out），执行完当前函数并返回上层
• 变量面板实时显示作用域变量、闭包、全局对象；鼠标悬停也可看值
• 调试控制台（Ctrl+Shift+Y）可执行任意 JS 表达式，比如修改变量、调用函数、检查 require.cache

若调试中报错“Cannot connect to runtime process”，大概率是端口被占或 Node 版本太低，可尝试改 port 字段（如 "port": 9229）或升级 Node。

基本上就这些。配置一次，后续调试基本不用再动 launch.json；配合断点和控制台，排查逻辑、异步流程、内存泄漏都更直观。不复杂但容易忽略的是：一定要打开整个文件夹，而不是单个 JS 文件——否则 VSCode 不会识别工作区，也无法正确解析路径变量如 ${workspaceFolder}。

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