答案是@vscode/node-extension-pack，它是微软官方维护的Node.js开发套件，含Debugger for Node.js、ESLint、Prettier等核心组件，支持一键安装与调试运行，需确保系统PATH中已配置Node.js可执行文件。
@vscode/node-extension-pack 是唯一能真正“一键”覆盖 Node.js 开发核心需求的扩展包，装它就对了——但前提是你的系统里已经装好了 Node.js 运行时。
为什么搜 “Node.js” 会装错？
VSCode 扩展市场里搜 Node.js，出来的结果混着几十个第三方插件，比如 Node Debug（已归档）、Node.js Extension（功能残缺）、JavaScript (ES6) code snippets（只提供片段）。它们不提供完整调试能力，断点常失效，甚至和新版 V8 协议不兼容。
必须输入完整名称：@vscode/node-extension-pack，认准作者是 Microsoft。它是一组预打包工具：Debugger for Node.js、ESLint、Prettier、npm 支持、JS/TS 语法增强，不是单个插件。
装完没反应？先查 node 是否在 PATH
@vscode/node-extension-pack 不带 Node.js 运行时，只负责编辑和调试支持。如果按 F5 报错 Command 'node' not found 或 Cannot find runtime 'node'，说明 VSCode 根本找不到本地 node 可执行文件。
- 在系统终端（不是 VSCode 内置终端）运行
node -v和npm -v，确认能输出版本号 - 运行
which node（macOS/Linux）或where node（Windows），看路径是否指向你安装的 Node.js（如/usr/local/bin/node或C:\Program Files\nodejs\node.exe） - 关掉所有 VSCode 窗口，**完全退出进程**（macOS 右键 Dock 图标选「退出」；Windows 在任务管理器结束所有
Code.exe） - 重启 VSCode，再打开内置终端（
Ctrl+`），立刻执行node -v—— 这次的结果才代表 VSCode 能调用到
调试失败常见配置陷阱
即使插件和 node 都正常，调试仍可能卡住或跳过断点。问题往往出在 .vscode/launch.json 或环境切换上：
- 项目根目录下没有
.vscode/launch.json？按F5后 VSCode 会提示生成，选Node.js环境即可，别手动删掉"runtimeExecutable": "node"这一行 - 用了
nvm或fnm管理多版本？必须先在 VSCode 终端里运行nvm use 20（或对应版本），再按F5，否则调试器默认用系统全局 node - 别在
settings.json里硬写"node.nodePath"—— 这个配置项从 VSCode 1.80+ 开始已废弃，写了也无效
离线安装或网络受限怎么办？
企业内网或无法访问 Marketplace 时，可手动下载 VSIX：
- 去 https://www.php.cn/link/1091267c6322ddc546912c53feee9b59（注意：实际页面 URL 中
vscode-node-azure-pack是旧名，正确 ID 是ms-vscode.node-extension-pack，搜索时以@vscode/node-extension-pack为准） - 点击 “Download Extension”，得到
.vsix文件 - VSCode 中按
Ctrl+Shift+P→ 输入Extensions: Install from VSIX→ 选中文件完成安装
复杂点在于环境变量刷新和多版本切换——很多人装完插件就以为万事大吉，其实 node 本身是否被 VSCode 正确识别，才是调试能否跑起来的第一道门槛。
