使用Vite创建React项目启动报错：找不到@rollup/rollup-win32-x64-msvc模块

问题描述 #

使用npm create vite@latest创建React项目，执行npm install后启动npm run dev时出现以下错误：

Error: Cannot find module @rollup/rollup-win32-x64-msvc. npm has a bug related to optional dependencies. Please try `npm i` again after removing both package-lock.json and node_modules directory.
    at requireWithFriendlyError (C:\vite-react-app\my-vite\node_modules\rollup\dist\native.js:64:9)
    at Object.<anonymous> (C:\vite-react-app\my-vite\node_modules\rollup\dist\native.js:73:48)

报错截图：

疑问：这个@rollup/rollup-win32-x64-msvc模块是什么？是否应该存在于项目中？

解决方案 #

1. 问题原因 #

这是npm可选依赖安装机制的已知bug导致的。Rollup会根据操作系统自动匹配对应的平台原生编译可选依赖，@rollup/rollup-win32-x64-msvc就是适配Windows x64平台的Rollup原生依赖，作用是提升Windows环境下的构建性能。但npm的bug导致该依赖未被正确安装，进而触发启动报错。

2. 模块必要性 #

它是Rollup的可选依赖，并非项目运行的强制核心依赖，但缺失会导致Vite调用Rollup时失败，因此需要确保它被正确安装。

3. 修复步骤 #

• 先删除项目目录下的node_modules文件夹和package-lock.json文件：
  Windows命令：

  rmdir /s /q node_modules
  del package-lock.json
  

  Mac/Linux命令：

  rm -rf node_modules
  rm package-lock.json
  

• 重新执行依赖安装：

  npm install
  

• 如果上述操作无效，尝试清除npm缓存后再重新安装：

  npm cache clean --force
  npm install
  

内容的提问来源于stack exchange，提问作者Gholamreza Vahidhashemi