VSCode需系统级安装Node.js并正确配置PATH才能运行，node -v报错即PATH未生效；调试须打开整个项目文件夹、正确配置launch.json；全局工具不可用需添加npm prefix至系统PATH并彻底重启VSCode。
VSCode 本身不提供 Node.js 运行环境，装了插件也跑不起来——必须先在系统级装好 Node.js，并确保 node 和 npm 命令能在终端里直接执行成功，VSCode 才能调用它。
node -v 报错“不是内部或外部命令”
这是 Windows 用户最常卡住的地方，根本不是 VSCode 配置问题，而是系统 PATH 没生效。
- 去
nodejs.org/download下载 LTS 版本（如 v20.15.1），运行 .msi 安装包时务必勾选 “Add to PATH” - 如果已跳过这步，手动把 Node.js 安装目录（比如
C:\Program Files\nodejs）加进「系统环境变量 → Path」 - 加完后彻底关闭所有 VSCode 窗口（任务管理器里确认
Code.exe进程已结束），再重新打开项目文件夹 - 按
Ctrl+`打开内置终端，立刻执行node -v和npm -v—— 只有这里能输出版本号才算真正可用
VSCode 调试时断点不触发或提示“无法启动程序”
常见原因是 launch.json 指向了错误路径，或者没在项目根目录下启动调试。
- 必须通过「文件 → 打开文件夹」打开整个项目（含
package.json或入口文件的目录），不能只打开单个.js文件 - 按
Ctrl+Shift+D进入调试视图，点「创建 launch.json」→ 选「Node.js」→ 选「当前文件」，VSCode 会生成"program": "${file}" - 如果项目有固定入口（如
server.js），把"program"改成"${workspaceFolder}/server.js"，别留默认的index.js - 调试前务必先保存文件（
Ctrl+S），VSCode 默认不会自动保存未修改的文件再运行
全局工具（如 nodemon）在 VSCode 终端里 command not found
说明 npm 全局 bin 目录没进 PATH，和 node 本身是否可用是两个独立问题。
- 运行
npm config get prefix查看当前全局路径（默认可能是C:\Users\XXX\AppData\Roaming\npm） - 把这个路径手动加进系统环境变量
Path（不是用户变量，是系统变量） - 加完后同样要完全重启 VSCode，只重启终端不够
- 国内建议提前配镜像：
npm config set registry https://registry.npmmirror.com，避免npm install卡死
最容易被忽略的是：VSCode 启动时读取的是它启动那一刻的系统 PATH 快照，改完环境变量不重启 VSCode，等于白改；另外，Code Runner 插件绕过项目上下文，遇到 "type": "module" 或 exports 字段时大概率报错，日常开发请直接用内置终端执行 node xxx.js。
