安装Vuetify Material Dashboard时npm run dev到64%-65%报错如何解决

问题复现背景 #

• 目标是部署使用Vuetify官方提供的Material Dashboard主题
• 全新设备从零安装失败，复现步骤如下：
  1. 完成Node.js和Git的基础安装
  2. 下载Vuetify Material Dashboard官方安装包
  3. 解压安装包后在根目录终端执行npm install安装依赖
  4. 执行npm run dev启动项目时，运行进度到64%~65%阶段出现报错

排查解决步骤 #

1. 检查Node.js版本兼容性
   Vuetify 3对应的Material Dashboard要求Node.js版本为16.x~18.x的LTS版本，高于19.x的版本会出现依赖编译兼容性问题。你可以执行node -v查看当前版本，版本不匹配的话卸载现有版本安装对应LTS版本即可。

2. 清除缓存后重装依赖
   npm缓存异常会导致依赖安装不完整，按顺序执行以下命令：

npm cache clean --force
rm -rf node_modules package-lock.json
npm install

如果是Windows系统无法识别rm命令，手动删除node_modules文件夹和package-lock.json文件后再执行npm install即可。

3. 调整端口占用配置
   部分Windows设备默认5173端口被占用也会导致dev启动到资源编译阶段报错，你可以修改package.json中dev启动命令，指定其他端口：
   把"dev": "vite"修改为"dev": "vite --port 3000"，保存后重新执行npm run dev测试。

4. 临时关闭安全软件扫描测试
   部分情况下Windows安全软件的实时扫描会拦截编译过程中临时文件的读写操作，导致进度卡在60%左右报错，你可以临时关闭实时保护后重新启动项目，确认是否是安全软件拦截导致的问题。

内容的提问来源于stack exchange，提问作者Juan José Campis