使用Vite创建React项目时npm i无法安装依赖且dev服务启动失败

以下是针对问题的具体解决方案：

• 清理npm缓存
  缓存损坏可能导致依赖安装异常，执行以下命令强制清理缓存：

  npm cache clean --force
  

  清理完成后回到项目根目录重新执行npm i。

• 检查项目package.json完整性
  确认项目根目录下的package.json存在且包含Vite依赖。如果是通过Vite初始化的项目，devDependencies中应当有类似"vite": "^5.x.x"的配置。若缺失，可在当前目录重新初始化项目：

  npm create vite@latest . -- --template react
  

  初始化完成后再执行npm i。

• 以管理员身份运行终端
  Windows普通权限可能限制文件写入，右键CMD或PowerShell选择「以管理员身份运行」，进入项目目录后执行npm i。

• 临时禁用npm严格SSL验证
  若网络环境导致SSL验证失败，可临时关闭严格模式：

  npm config set strict-ssl false
  

  安装完成后建议改回：

  npm config set strict-ssl true
  

• 核对Node.js与npm版本兼容性
  执行node -v和npm -v查看版本，确保两者版本匹配（如Node.js 18对应npm 8.x+，Node.js 20对应npm 9.x+）。版本不匹配时，重新安装对应版本的Node.js（自带适配的npm）。

• 清理项目残余文件
  删除项目目录下的yarn.lock（如果存在）、package-lock.json（如果有残留），再执行npm i。

• 排查杀毒软件拦截
  临时关闭Windows Defender或第三方杀毒软件，测试npm i是否成功。若成功，将项目目录加入杀毒软件的信任列表。

内容的提问来源于stack exchange，提问作者Ethan Gula