VSCode需安装@vscode/node-extension-pack插件才能支持Node.js开发；配置node.runtimePath为完整可执行文件路径；项目须以文件夹形式打开并规范放置.launch.json于根目录。
VSCode 默认不带 Node.js 开发支持，必须装插件才能获得调试、智能提示、断点、自动补全等能力——不装插件，launch.json 会报错，F5 调试直接失败。
怎么找对插件：认准 @vscode/node-extension-pack
搜索“Node.js”会出现几十个结果，但只有微软官方维护的 @vscode/node-extension-pack 是真正开箱即用的一体化方案。它包含：Debugger for Node.js（核心调试器）、ESLint（代码检查）、JavaScript (ES6) code snippets（常用模板）等。别选单个插件拼凑，容易版本冲突或功能缺失。
- 在 VSCode 扩展面板里搜
@vscode/node-extension-pack，认准发布者是 Microsoft - 如果搜不到，说明网络受限，需手动下载 VSIX 文件（见下一条）
- 装完后不用重启，但首次调试前建议关掉所有终端窗口，避免旧进程干扰
离线安装失败？VSIX 路径含空格或中文会静默报错
手动安装 .vsix 时，VSCode 命令 Extensions: Install from VSIX 对路径极其敏感：只要路径里有空格（如 C:Program Files）或中文（如 桌面），安装就会卡住或提示“无法读取包”，但不报具体错误。
- 把
.vsix文件复制到一个纯英文、无空格的路径，例如C: six ode-pack.vsix - 用命令面板执行
Extensions: Install from VSIX，再从该路径选择文件 - 装完检查扩展列表里是否显示“Enabled”，而不是灰色“Install”按钮
node.runtimePath 配置错，调试器启动就退出
插件装好了，但按 F5 后控制台一闪而过、没输出、也没报错？大概率是 node.runtimePath 指向了不存在的路径，或者指向了 node.exe 的父目录而非文件本身。
- 终端运行
which node（macOS/Linux）或where node（Windows），拿到真实路径，例如/usr/local/bin/node或C:Program Files odejs ode.exe - 在
settings.json中写成完整可执行文件路径，不能只写到nodejs目录 - 路径中反斜杠要双写（Windows）：
"node.runtimePath": "C:\Program Files\nodejs\node.exe" - 改完保存，不要重启 VSCode，但要关掉所有已打开的调试终端
调试时找不到 launch.json？项目根目录结构必须规范
VSCode 不会自动创建 .vscode/launch.json，而且它只在“当前打开的文件夹是项目根目录”时才生效。如果你只是打开了单个 demo.js 文件，而不是整个项目文件夹，launch.json 就会被忽略。
- 用 VSCode 的
File > Open Folder...打开包含package.json的文件夹 - 确保
.vscode是项目根目录下的子目录，不是嵌套在 src 或其他子目录里 -
launch.json中的program字段要写相对路径，例如"${workspaceFolder}/index.js"，不能写绝对路径或错误的文件名
最常被忽略的是：插件装了、路径配了、launch.json 也写了，但调试器仍不触发——八成是因为你没在项目根目录下打开文件夹，或者 program 指向了一个根本不存在的 JS 文件。
