VS Code调试Node.js需确保环境就绪、正确配置launch.json，支持launch/attach模式、断点类型及sourceMaps，适配Express/TS/Next.js等场景。
在 VS Code 中调试 Node.js 应用并不复杂，关键在于配置正确、理解调试流程、善用内置工具。以下是最实用、最贴近真实开发场景的操作路径。
确保 Node.js 和 VS Code 环境就绪
VS Code 自带 Node.js 调试支持（基于 Chrome DevTools Protocol），无需额外插件（如旧版的 Debugger for Node.js 已集成）。确认两点：
- 终端中运行 node -v 返回有效版本（建议 v14.18+ 或 v16.14+，支持 ESM 调试）
- VS Code 版本 ≥ 1.70（推荐使用最新稳定版，避免断点失效等已知问题）
快速启动调试：自动配置 launch.json
打开项目根目录，按 Ctrl+Shift+D（Windows/Linux）或 Cmd+Shift+D（macOS）进入调试视图，点击齿轮图标 ⚙️。VS Code 会提示选择环境 —— 选 Node.js，它将自动生成 .vscode/launch.json。
默认配置通常足够启动常见脚本，例如：
{
"version": "0.2.0",
"configurations": [
{
"type": "node",
"request": "launch",
"name": "Launch Program",
"skipFiles": ["<node_internals>/**"],
"program": "${workspaceFolder}/index.js",
"console": "integratedTerminal"
}
]
}
注意：program 字段必须指向可执行入口文件（支持 .js、.ts 经 tsc 编译后、或通过 ts-node 运行）；若用 ESM（type: "module"），需加 "runtimeArgs": ["--loader", "ts-node/esm"]（配合 ts-node）或确保 Node.js 启动参数兼容。
高效设置断点与观察变量
在代码行号左侧灰色区域单击即可设断点（红点），支持：
- 条件断点：右键断点 → “编辑断点” → 输入 JavaScript 表达式（如 user.id > 100）
- 日志点：右键 → “添加日志点”，输入模板如 用户登录: ${user.name}，不中断执行但输出到 Debug Console
- 在 变量（VARIABLES） 面板中展开 Local、Closure、Global 查看作用域数据
- 在 WATCH 面板中手动输入表达式（如 process.env.NODE_ENV 或 req.headers）实时求值
调试 Express、Next.js 或 TypeScript 项目
不同框架只需微调 launch.json：
- Express（监听端口）：添加 "env": { "NODE_ENV": "development" }，并确保 program 指向启动文件（如 app.js），避免调试器在 server.listen() 后立即退出 —— 可加 "stopOnEntry": false 和断点在路由处理函数内
-
TypeScript：推荐两种方式：
✓ 先用 tsc --watch 编译，program 指向 ./dist/index.js，启用 "sourceMaps": true
✓ 或直接运行源码：安装 ts-node，配置 "runtimeExecutable": "npx"，"runtimeArgs": ["ts-node", "--project", "./tsconfig.json"]，再设 "sourceMaps": true - Next.js：不建议直接调试 dev server；改用 next build && next start 后调试 .next/server/pages/...，或使用 next dev --inspect + attach 模式（见下条）
进阶：Attach 到已有 Node 进程
适合调试已启动的服务（如 pm2、forever、或命令行中手动运行的 node --inspect-brk app.js）：
- 在终端运行带调试标志的进程：node --inspect-brk=9229 app.js（--inspect-brk 会在第一行暂停）
- 在 launch.json 新增配置：
{
"type": "node",
"request": "attach",
"name": "Attach to Process",
"port": 9229,
"address": "localhost",
"restart": true,
"sourceMaps": true,
"outFiles": ["${workspaceFolder}/dist/**/*.js"]
}
然后从调试面板选择该配置并点击 ▶️。VS Code 将连接到正在监听 9229 端口的 Node 进程。
基本上就这些。不需要记一堆命令，核心是理解 launch.json 的 role（launch vs attach）、sourceMaps 的作用、以及断点类型的适用场景。配好一次，后续调试就和写代码一样自然。
