VSCode终端找不到全局安装的npm包，根本原因是npm prefix路径未加入系统PATH；需运行npm config get prefix确认路径，手动将其添加至系统环境变量（Windows）或$PATH（macOS/Linux），并重启VSCode使集成终端加载新PATH。
VSCode终端里npm install -g装的包找不到？先看prefix配对没
全局模块装到哪，不取决于VSCode，而取决于npm的prefix配置。默认是C:Users{user}AppDataRoaming
pm（Windows）或~/.npm-global（macOS/Linux），但这个路径未必在系统PATH里，VSCode终端自然找不到命令。
- 运行
npm config get prefix确认当前全局安装路径 - 如果路径含空格（如
D:Program Files odejs ode_global），必须用双引号包裹，否则npm config set prefix会静默失败 - 改完后，**必须手动把该路径加进系统环境变量
Path（Windows）或$PATH（macOS/Linux）**，否则VSCode终端启动时读不到 - 验证：新开VSCode终端，执行
echo $PATH（macOS/Linux）或echo %PATH%（CMD）或$env:PATH（PowerShell），确认输出里有你设的prefix路径
Windows下PowerShell和CMD的PATH不互通，VSCode可能只认其中一个
VSCode默认用PowerShell做集成终端，但你很可能在CMD里配过环境变量——PowerShell不会自动继承CMD的修改，这是最常被忽略的断层。
- 在VSCode终端里运行
$env:PATH，检查Node安装目录（如D: odejs）和prefix路径是否都在里面 - 如果缺，别去改系统环境变量，直接在VSCode设置里搜
terminal.integrated.env.windows，填入："terminal.integrated.env.windows": { "PATH": "%PATH%;D:\nodejs;D:\nodejs\node_global" } - 注意：路径里的反斜杠要写成
\或统一用/，否则JSON解析失败 - 改完设置后，**必须完全关闭VSCode再重开**，只关终端标签页无效
launch.json里runtimeExecutable不填，调试器就靠PATH找node
“Can’t find Node.js binary ‘node’”这个报错，90%不是环境没配好，而是VSCode调试器压根没走系统PATH查找逻辑——它只信任launch.json里写的runtimeExecutable，或者你根本没配这个字段却误以为它会自动 fallback。
- 项目根目录下建
.vscode/launch.json，确保configurations里有："runtimeExecutable": "D:/nodejs/node.exe"
（路径用正斜杠更安全） - 如果不想硬编码路径，删掉
runtimeExecutable这一行，让调试器按系统PATH搜索——但前提是前面两步已确保PATH正确且VSCode终端能node -v - nvm/fnm用户别指望调试器自动识别版本切换，必须显式写死路径，比如
"runtimeExecutable": "~/.nvm/versions/node/v20.15.0/bin/node"
NODE_PATH不是摆设，但只影响require()，不影响import或ESM
NODE_PATH环境变量的作用很窄：它只扩展require()的模块查找路径，对import、TypeScript、ESM项目完全无效。很多人配了却没效果，是因为用错了场景。
- 如果你用
require('express')报Cannot find module，且express确实装在node_global ode_modules里，那就需要设NODE_PATH指向D: odejs ode_global ode_modules - 但如果是
import express from 'express'失败，问题出在tsconfig.json的typeRoots或moduleResolution，跟NODE_PATH无关 - Windows设
NODE_PATH必须用系统变量（不是用户变量），且值末尾**不能带ode_modules**——VSCode会自动拼接，多加反而导致路径错误
PATH、prefix、runtimeExecutable这三个点上，漏掉任何一个环节，软链接就只是硬盘上一堆看不见的文件。 
