能跑 node -v 和 npm -v，且 vscode 按 f5 能断点调试，才算真正载入了 node.js 运行核心；其余插件、格式化、ts 支持，全是后续可选动作。验证 node 和 npm 是否真在系统 path 里很多人卡在这一步，却以为是 vscode 的问题。
能跑 node -v 和 npm -v，且 VSCode 按 F5 能断点调试，才算真正载入了 Node.js 运行核心；其余插件、格式化、TS 支持，全是后续可选动作。
验证 node 和 npm 是否真在系统 PATH 里
很多人卡在这一步，却以为是 VSCode 的问题。打开系统终端（不是 VSCode 内置终端），执行：
node -v npm -v
如果报错 'node' 不是内部或外部命令 或 command not found: npm，说明 Node.js 没进系统 PATH。
- Windows 用户：LTS 安装时必须勾选 Add to PATH；若漏了，手动把安装目录（如
C:\Program Files\nodejs）加到「系统环境变量 → Path」，然后彻底关闭所有终端和 VSCode 窗口再重开 - Windows 还要避开中文或空格路径（如
D:\我的软件\nodejs），否则npm可能静默失败 - macOS/Linux 用户用
nvm：确认source ~/.nvm/nvm.sh已写入~/.zshrc（或~/.bash_profile），且新开终端已加载 -
npm -v必须成功——VSCode 调试器底层靠它启动脚本，不是可选项
VSCode 内置调试器直接可用，不需要额外插件
VSCode 自带 Node.js 调试支持，Debugger for Node.js、Node.js Extension Pack 这类插件在 2026 年已过时，装了反而可能冲突。
- 新建项目文件夹，创建
index.js，写一行console.log('ok'); - 按
Ctrl+Shift+P（macOS 是Cmd+Shift+P），输入Debug: Open Configuration，选Node.js → Current File - VSCode 自动生成
.vscode/launch.json，关键字段是"program": "${file}"—— 表示运行当前打开的 JS 文件 - 在代码行号左侧单击设断点，按
F5启动；若提示Cannot find runtime 'node'，一定是第一步的环境没配好，不是配置问题
不要硬写 node.nodePath 或 runtimeExecutable 绝对路径
VSCode 1.80+ 版本已废弃 node.nodePath 配置项，读取无效；手动填绝对路径（如 /usr/local/bin/node）看似“稳妥”，实则破坏多版本切换能力，且容易因重装、升级失效。
- 确保
launch.json中没有手动设置"runtimeExecutable"，或明确设为"node"（字符串，非路径） - 若用
nvm或fnm管理多版本：先在 VSCode 内置终端中运行nvm use 20切换好版本，再按F5 - 调试前别依赖 VSCode 设置里的
node.nodePath，它不生效，纯属误导
@vscode/node-extension-pack 是唯一真正“一键”的扩展包
它不是单个插件，而是微软官方打包的开发套件（含调试器、ESLint、Prettier、代码片段等），但前提是本地 node 命令必须可用。
- 在 VSCode 扩展面板搜索
@vscode/node-extension-pack（注意前缀@vscode/，缺了就是第三方旧包） - 认准作者是 Microsoft，点击 Install 即可
- 装完不生效？不是插件问题，检查
node -v是否能在 VSCode 终端里执行成功；若不行，关掉所有 VSCode 进程（macOS 右键 Dock 选「退出」，Windows 任务管理器结束Code.exe），再重开
最常被忽略的点：VSCode 内置终端是否继承了你 shell 的环境变量。哪怕系统终端能跑 node，VSCode 终端也可能没加载 nvm 或 PATH，导致调试器找不到 node —— 这时候不是改配置，而是要让它“重启继承”。
