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，例如最常用的启动配置：
{
"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}。
