node和npm必须在系统终端中能直接运行，否则vscode无法调用；需先在系统终端验证node -v和npm -v，失败则修复path（windows勾选add to path或手动添加，macos/linux确保nvm配置已加载），再从终端执行code .启动vscode。
Node 和 npm 必须在系统终端里能直接运行，VSCode 才可能调用它们——这不是 VSCode 配置问题，而是你本地环境是否真正就绪。
node -v 和 npm -v 在系统终端里报错怎么办
别急着改 VSCode 设置。先打开系统自带的终端（Windows 是 cmd/PowerShell，macOS/Linux 是 Terminal），执行：
-
node -v和npm -v—— 如果报'node' is not recognized as an internal or external command或command not found，说明 Node.js 根本没进系统 PATH - Windows 用户：重装 Node.js 时务必勾选 Add to PATH；若已装完，手动把
C:\Program Files\nodejs（或你自定义的安装路径）加进系统环境变量Path - macOS/Linux 用户：若用
nvm，确认source ~/.nvm/nvm.sh已写入~/.zshrc或~/.bash_profile，且新终端已加载 - 验证方式：关掉所有终端窗口，新开一个，再跑
node -v；成功后，再开 VSCode（不是点桌面图标，而是从该终端执行code .）
npm 全局路径和镜像必须提前配好
npm 默认把全局模块（如 nodemon）装到系统盘，国内直连官方 registry 经常卡住——这两处不配，后续调试、热重载、甚至 import 补全都会出问题：
- 换淘宝镜像：
npm config set registry https://registry.npmmirror.com - 改全局安装路径（比如放 D 盘）：
npm config set prefix "D:\npm-global" - 把该路径加进系统
Path（Windows）或 shell 的PATH（macOS/Linux） - 验证：
npm config get prefix和npm config get registry应输出你设的值 - 重装全局工具：
npm install -g nodemon，然后在任意目录试nodemon --version
launch.json 中 program 和 runtimeExecutable 容易写错
VSCode 调试器找不到入口或报 Cannot find runtime 'node'，90% 是这两个字段填得不对：
-
"program": "${file}"—— 适合单文件临时调试；但保存前没按Ctrl+S，断点不会生效 -
"program": "${workspaceFolder}/index.js"—— 必须确保该文件真实存在；别写成src/index.js（ESM/TS 项目要指向编译后的dist/index.js） -
"runtimeExecutable": "npm"+"runtimeArgs": ["start"]—— 用于调试npm start启动的服务，此时必须加"console": "integratedTerminal"，否则看不到日志 -
"runtimeExecutable": "nodemon"是错的——nodemon不是 Node 运行时，不能直接当runtimeExecutable；要用 attach 模式：命令行先跑nodemon --inspect-brk index.js，再在launch.json里配"request": "attach"和对应port
VSCode 终端继承不到 npm 配置的常见原因
你在系统终端里能用 nodemon，但在 VSCode 集成终端里提示 command not found，大概率是终端没读取 shell 配置：
- macOS/Linux：检查
~/.zshrc是否包含export PATH="...:$PATH"，并在 VSCode 终端里手动执行source ~/.zshrc - Windows：若用
nvm-windows，确保已执行nvm use 20.15.0再启动 VSCode；或者直接在 VSCode 设置里填node.runtimePath（值为where node输出的绝对路径） - 重启 VSCode 是最简单的解法——关掉所有窗口，重新从终端启动
code . - 注意：
npm install后如果 import 提示波浪线，不是插件问题，而是 VSCode 缓存了旧的node_modules结构；必须彻底关闭 VSCode 再重开，不能只 Reload Window
最关键的其实是：VSCode 本身不“装” Node.js，它只是个调用器。所有配置都围绕一件事展开——让 node 和 npm 的可执行路径、版本、环境变量，在 VSCode 启动那一刻就对齐你系统里真实有效的那一套。任何跳过系统终端验证的配置，后面都会反复踩坑。
