在 VSCode 中调试 Node.js 应用需正确配置 launch.json 并启动调试会话，推荐使用 Launch Program 模板自动检测入口文件，或通过 Attach 模式连接已运行的 --inspect-brk 进程。
在 VSCode 中调试 Node.js 应用非常方便，关键在于正确配置 launch.json 并启动调试会话，而不是依赖命令行手动加 --inspect。
确保 Node.js 和 VSCode 支持调试
VSCode 自带 Node.js 调试支持（通过内置的 Node Debug Adapter），无需额外安装插件。但需确认：
- Node.js 版本 ≥ 12（推荐使用 LTS 版本，如 18.x 或 20.x）
- VSCode 已更新至最新稳定版
- 项目根目录下有
package.json（非必需，但便于识别入口文件）
自动生成 launch.json 配置
打开你的 Node.js 项目文件夹，在 VSCode 中按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS），输入 Debug: Open launch.json，选择 Node.js 环境。VSCode 会生成一个默认配置文件。
最常用的是 Launch Program 模板，它会自动检测 package.json 中的 "main" 字段，或默认指向 index.js。若入口文件不是 index.js，请手动修改 "program" 字段，例如：
"program": "${workspaceFolder}/src/server.js"
启动调试并设置断点
打开要调试的 JS 文件，在行号左侧灰色区域单击即可添加断点（红点）。然后按 F5 启动调试 —— VSCode 会自动运行 Node.js 进程，并在断点处暂停。
调试过程中可使用以下功能：
- 变量面板查看当前作用域变量值
- 调试控制栏进行“继续”、“单步跳过”、“单步进入”、“单步跳出”
- 终端（DEBUG CONSOLE）中直接执行 JS 表达式，比如
process.env.NODE_ENV - 按 Ctrl+Shift+Y（或 Cmd+Shift+Y）打开调试控制台
调试已运行的 Node.js 进程（Attach 模式）
适用于需要调试已通过 npm start 或 node server.js 启动的服务。先以调试模式启动进程：
node --inspect-brk=9229 server.js
然后在 launch.json 中添加一个 Attach to Process 配置：
{
"type": "node",
"request": "attach",
"name": "Attach to Process",
"port": 9229,
"address": "localhost",
"sourceMaps": false,
"skipFiles": ["<node_internals>/**"]
}
保存后，从调试侧边栏选择该配置，再按 F5 即可连接。
