Visual Studio新建Node.js项目NPM包缺失无法安装怎么办

• Visual Studio内置Node.js项目模板仅在package.json中写入依赖声明，不会自动执行依赖拉取操作，若VS自带的npm集成模块未识别到本地npm环境，会直接给依赖标注(missing)
• 本地Node.js/npm未配置系统环境变量，或VS的外部工具路径优先级配置错误，导致VS找不到npm可执行程序，会出现安装按钮置灰、点击安装无响应的问题
• 旧版本VS的Node.js开发组件存在兼容性bug，对npm 8及以上版本适配不全，会偶发操作无响应、依赖识别错误
• 项目路径下存在之前生成失败的缓存文件（如VS生成的Node分析缓存、残缺的node_modules文件夹），会干扰依赖识别逻辑

基础环境配置校验 #

1. 打开系统命令提示符，依次执行node -v、npm -v：
   • 如果提示命令不存在，先安装Node.js，安装过程中务必勾选Add to system PATH选项，安装完成后重启电脑
   • 如果能正常输出版本号，打开VS依次进入「工具-选项-项目和解决方案-Web Package Management-外部Web工具」，将本地Node.js的安装路径（默认路径为C:\Program Files\nodejs）上移到优先级列表最顶部，保存配置后重启VS
2. 打开Visual Studio Installer，选择当前使用的VS版本点击「修改」，确认「Node.js开发」工作负载已勾选，同时在单个组件列表中确认Node.js开发工具为最新版本，更新完成后重启VS

手动安装依赖规避VS集成按钮异常 #

不要依赖VS右键菜单的npm安装选项，直接按以下流程操作：

• 右键项目节点，选择「在文件资源管理器中打开文件夹」，定位到package.json所在的项目根目录
• 在文件夹地址栏输入cmd按回车，直接在当前路径打开命令行
• 执行npm install命令等待所有依赖安装完成，如果报权限错误，就关闭VS后用管理员身份打开命令提示符再执行该命令
• 回到VS中右键解决方案资源管理器里的npm文件夹，选择「刷新」，所有依赖的missing标识就会消失

缓存异常兜底处理 #

如果上述操作后还是偶发识别错误，直接关闭VS，删除项目根目录下的.ntvs_analysis.dat缓存文件和整个node_modules文件夹，重新执行npm install后再打开VS刷新即可。该缓存文件是VS Node工具自动生成的分析文件，删除不会影响项目代码。

内容的提问来源于stack exchange，提问作者Brian Lorraine