VS Code 不自带 Node.js，需单独安装并正确配置 PATH 环境变量；若 node -v 报错，应检查并添加 node.exe 路径及 npm 全局 bin 路径（如 %APPDATA%\npm\node_modules.bin），且必须重启所有终端。
VS Code 本身不安装 Node.js，它只是编辑器；Node.js 必须单独安装并正确配置环境变量，VS Code 的终端才能识别 node 和 npm 命令。
node -v 报“不是内部或外部命令”怎么办
这是最常见问题，本质是 Windows 没把 node.exe 路径写进系统 PATH。哪怕安装时勾选了 “Add to PATH”，杀毒软件、组策略或旧版安装器也可能跳过这步。
- 运行
where node，如果没输出，说明系统完全找不到node.exe - 默认路径通常是
C:\Program Files\nodejs\（LTS 安装）或C:\nodejs\（自定义路径） - 进入「系统属性 → 高级 → 环境变量」→ 编辑「系统变量」里的
Path→ 新建 → 粘贴上述路径 - 必须重启所有已打开的终端（包括 VS Code 内置终端），否则改了也无效
别重装 Node.js —— 重装不会自动修复漏写的 PATH，反而可能叠加重复路径，导致后续 npm 找包混乱。
npm install -g 后命令仍不可用（如 express）
这不是安装失败，而是 npm 全局 bin 目录没进 PATH。LTS 版 Node.js 默认把全局模块装到 %APPDATA%\npm，而可执行文件实际在它的子目录 node_modules.bin 下。
- 先查真实位置：运行
npm config get prefix，比如输出C:\Users\Alice\AppData\Roaming\npm - 那么全局命令实际在
C:\Users\Alice\AppData\Roaming\npm\node_modules.bin - 把这个
.bin路径（不是prefix根目录！）追加进系统Path - 关闭所有终端，新开一个，再试
express --version
很多人卡在这里，是因为只加了 prefix，却漏掉了 .bin —— 这是 npm 的设计逻辑，不是 bug。
VS Code 终端里 node/npm 有，但调试断点不命中
VS Code 自带 Node.js 调试器，默认不启用 source map，也不自动识别 package.json 中的 "type": "module"。
- 如果项目用 ESM（
import/export），确保launch.json中包含：{ "type": "pwa-node", "request": "launch", "runtimeArgs": ["--experimental-specifier-resolution=node"], "sourceMaps": true, "outFiles": ["${workspaceFolder}/dist/**/*.js"] } - 如果用了 TypeScript 或 Babel 编译，必须生成且指向正确的
.map文件路径 - 检查当前工作区是否在项目根目录（含
package.json），否则调试器可能无法读取配置
断点失效往往不是环境没装好，而是调试配置和项目类型不匹配。
关键点始终就两个：路径写对、终端重启。Windows 上的 PATH 是逐条匹配的，顺序错、多空格、少 .bin 都会导致命令找不到。别跳步骤，一条一条验证。
