node.js未加入系统path导致vscode调试失败，需在系统终端验证node -v/npm -v，windows重装时勾选“add to path”或手动添加路径，macos/linux用nvm需确保nvm.sh已加载，修改path后必须重启终端和vscode。
node -v 在系统终端报错，VSCode 调试直接失败
根本不是 VSCode 的问题，而是 Node.js 根本没进系统 PATH。VSCode 调试器启动时会调用 node 命令，如果系统找不到它，就会卡在 Cannot find runtime 'node' 或静默退出。
必须在**系统终端**（Windows 是 CMD/PowerShell，macOS/Linux 是 Terminal.app 或 iTerm）里执行：
node -v npm -v
两者都输出版本号才算过关。如果报 'node' 不是内部或外部命令，说明安装时漏了关键一步：
- Windows：重装 Node.js LTS 版，务必勾选 “Add to PATH”；若已装过，手动把
C:\Program Files\nodejs（或你实际的安装路径）加到系统环境变量Path里 - macOS/Linux：用
nvm的用户，确认source ~/.nvm/nvm.sh已写入~/.zshrc或~/.bash_profile，且新开终端已加载 - 所有平台：改完 PATH 后，**必须关闭并重新打开所有终端窗口和 VSCode 实例**，否则缓存未刷新
VSCode 内置终端能跑 node，但调试器提示 “无法启动程序”
这说明环境变量继承不完整——VSCode 终端可能读到了 PATH，但调试器启动时用的是另一套上下文（比如没加载 shell 配置），或者 launch.json 指向了不存在的文件。
检查三件事：
-
launch.json中的"program"字段：默认是"${workspaceFolder}/index.js"，如果你的入口是app.js，就得改成"${workspaceFolder}/app.js" - 确保你是通过 “文件 → 打开文件夹” 打开整个项目根目录（含
package.json或主 JS 文件），而不是只打开单个.js文件 - 调试前按
Ctrl+S（Windows/Linux）或Cmd+S（macOS）保存当前文件——VSCode 默认不会自动保存未保存的文件，断点设在未保存内容上会失效
npm install 后 import 报红，但 node app.js 能跑
说明运行时环境没问题，但 VSCode 的语言服务（IntelliSense）没识别到模块。这不是路径或语法错误，而是类型索引没刷新或配置没生效。
常见原因和动作：
- 执行过
npm install但没重启 VSCode：关掉所有 VSCode 窗口，重新打开项目文件夹——仅Developer: Reload Window不够，它不重建node_modules的类型索引 - 用了
@types/xxx但jsconfig.json或tsconfig.json没启用"types"或"typeRoots"字段 - ESM 项目中混用
require()加载 CommonJS 包，导致类型声明不匹配；优先改用import，或确保package.json有"type": "module"
全局工具（如 nodemon）在 VSCode 终端里 command not found
哪怕 npm install -g nodemon 在系统终端成功，VSCode 终端仍找不到，大概率是 npm 全局 bin 目录没进 PATH。
查一下你全局安装的位置：
npm config get prefix
然后把该路径下的 bin 子目录（Windows 是 \bin，macOS/Linux 是 /bin）加进系统 PATH。例如：
- Windows：如果
npm config get prefix输出D:\npm-global，就把D:\npm-global\bin加进系统环境变量 - macOS/Linux：如果输出
/usr/local/lib/node_modules，对应 bin 路径通常是/usr/local/bin，确认它已在$PATH中
加完后，**必须彻底关闭 VSCode 并重开**，内置终端才会读取更新后的 PATH。
