npm命令无法识别而node正常，主因是path未包含node安装路径、powershell执行策略阻止.ps1脚本、npm全局配置指向旧路径、vscode终端缓存旧环境变量或npm缓存/代理污染。
npm -v 报错但 node -v 正常，说明 npm 二进制没被识别
Node 升级后 npm 突然失效，最常见的情况是：node 命令能用，npm 却提示 npm : 无法将"npm"项识别为 cmdlet...。这不是 npm 被删了，而是 PowerShell 拒绝执行它——因为升级 Node 时，旧版 npm 的 wrapper 脚本（npm.ps1）残留或权限策略未同步更新。
关键判断点：Get-Command npm 如果返回的是 C:UsersxxxAppDataRoaming
pm
pm.ps1 这类路径，而非 C:Program Files
odejs
pm.cmd，就坐实了问题根源：PowerShell 在执行 .ps1 脚本前卡在策略上。
- 先别急着重装，检查当前策略：
Get-ExecutionPolicy -List，重点关注CurrentUser和Process行 - 如果
CurrentUser是Undefined或Restricted，就需显式放行：Set-ExecutionPolicy RemoteSigned -Scope CurrentUser - 不推荐用
Administrator权限全局改策略，仅对当前用户生效更安全
npm config get prefix 返回异常路径，指向已删除的旧版本
Node 升级常伴随安装路径变更（比如从 C:Program Files
odejs 换成 C:Program Files
odejs-v18），但 npm 的全局配置仍固执地记着老地方。此时 npm -v 可能静默失败，npm install -g xxx 则报 EPERM 或 ENOTDIR。
运行 npm config get prefix，如果输出类似 C:UsersxxxAppDataRoaming
pm 或一个根本不存在的路径，说明 npm 的“家”丢了。
- 先确认新 Node 的真实安装根目录：
where node（Windows）或which node（macOS/Linux） - 把 prefix 改成新路径下的
node_modules同级目录：npm config set prefix "C:Program Files odejs" - 同时修正缓存路径：
npm config set cache "C:Program Files odejs ode_cache" - 删掉旧的
%APPDATA% pm目录（Windows）或~/npm（macOS），避免冲突
VSCode 终端仍加载旧环境变量，重启也不生效
即使系统 PATH 已更新，VSCode 的集成终端可能还在用启动时缓存的环境变量。尤其当你从旧版 Node 升级、又没彻底关掉所有 VSCode 实例时，这个问题特别顽固。
验证方法：在 VSCode 终端里运行 $env:Path -split ';' | Select-String 'nodejs'（PowerShell）或 echo $PATH | grep nodejs（bash/zsh）。如果看到多个 nodejs 路径，或路径指向旧版本，就是环境变量没刷新。
- 关闭所有 VSCode 窗口（包括托盘进程），再重新打开——这是最简单有效的刷新方式
- 如果仍不行，在 VSCode 设置里搜
terminal.integrated.env，手动添加："terminal.integrated.env.windows": {"PATH": "C:\Program Files\nodejs;${env:PATH}"} - 避免修改
settings.json中的terminal.integrated.shellArgs，容易引发 Shell 初始化异常
npm install -g npm 无反应或卡住，本质是代理/缓存污染
升级 Node 后执行 npm install -g npm 卡在 fetchMetadata 或直接退出，大概率不是网络问题，而是旧 npm 缓存里混进了损坏的包描述或错误 registry 配置。
典型现象：npm config list 显示 registry 是 https://registry.npmjs.org/，但 npm view npm version 却超时；或者 npm cache verify 报出大量 integrity checksum failed。
- 强制清空缓存：
npm cache clean --force（注意双短横） - 临时切回官方源：
npm config set registry https://registry.npmjs.org/ - 用绝对路径绕过 shell 查找：
C:Program Files odejs pm.cmd install -g npm - 如果公司内网有镜像，确保
.npmrc文件里只有一条 registry 配置，不要和环境变量里的重复
真正麻烦的不是 npm 不工作，而是它“半工作”——比如 npm -v 能返回版本，npm install 却报错找不到 package-lock.json。这种时候，优先检查 npm config get prefix 和 Get-ExecutionPolicy，90% 的升级后失联都发生在这两个点上。别跳步，一行命令一行命令验证过去。
