VS Code终端运行npm命令提示未识别报错如何修复？

报错复现 #

执行命令：npm init -y
返回错误：

npm : 无法将“npm”项识别为 cmdlet、函数、脚本文件或可运行程序的名称。请检查名称拼写，若包含路径请验证路径正确性后重试。
At line:1 char:1
  + CategoryInfo          : ObjectNotFound: (npm:String) [], CommandNotFoundException
  + FullyQualifiedErrorId : CommandNotFoundException

排查解决步骤 #

按优先级从高到低操作：

• 先验证系统层面是否能识别npm
  完全关闭VS Code，打开系统自带的PowerShell或命令提示符，分别执行node -v、npm -v
  • 如果系统终端也报同样的识别错误：
    • 首先确认是否安装了Node.js，npm是Node.js自带的包管理工具，不会单独分发，未安装的话直接安装Node.js，安装过程中必须勾选「Add to PATH」选项，安装完成后重启电脑。
    • 如果确认已经安装Node.js，手动把Node.js安装目录、npm全局模块目录添加到系统环境变量Path中，默认安装路径参考：

      C:\Program Files\nodejs\
      C:\Users\【替换为你的系统用户名】\AppData\Roaming\npm
      

      路径添加完成后关闭所有终端窗口，重新打开系统终端执行npm -v，能正常输出版本号即配置生效。
• 如果系统终端可正常运行npm，仅VS Code终端识别不到
  • 首先完全退出VS Code（打开任务管理器确认所有VS Code相关进程都已结束），重新启动VS Code后再试，这类问题绝大多数是VS Code启动时未加载到更新后的系统环境变量导致的。
  • 如果重开后仍报错，检查VS Code当前使用的终端环境：是否误切到了WSL、远程开发容器、其他隔离环境，这类隔离环境默认和本地系统环境不互通，未在环境内单独安装Node.js就会出现找不到命令的问题，切回本地PowerShell/CMD终端即可。
• 特殊情况处理
  若前两步操作完成后仍有异常，以管理员身份打开PowerShell，执行Set-ExecutionPolicy RemoteSigned，输入Y确认执行策略修改后，重启终端再验证npm命令可用性。

验证方式 #

在VS Code终端执行npm -v，能正常返回版本号时，再执行npm init -y即可正常运行。

内容的提问来源于stack exchange，提问作者Kanayo Justice