本地Git文件夹运行Quasar CLI项目遇vite-plugin-checker报错求助

问题描述 #

克隆远程仓库后，执行npm init quasar完成SPA项目初始化，运行quasar dev时出现提示：

App • ⚠️ quasar.config.js > invalid Vite plugin specified (cannot find it): vite-plugin-checker

浏览器打开后，网络调试工具显示404错误，页面无内容加载。

已确认信息：

• vite-plugin-checker已存在于package.json和node_modules中
• 运行quasar dev前未修改任何文件

已尝试操作：

• 移除该Vite插件后运行quasar dev
• 重新初始化项目
• quasar build可成功执行
• 删除node_modules后重新执行npm install再运行quasar dev

特殊发现：将项目生成在非Git文件夹中时，可正常运行。

解决方案建议 #

• 检查Git仓库的.gitignore规则
  大概率是仓库的.gitignore包含了影响Vite插件加载的路径，比如误将node_modules/.vite缓存目录或插件相关子目录加入忽略。可以临时重命名.gitignore为.gitignore.bak，重新执行npm install和quasar dev测试是否恢复正常。

• 清理缓存

  • 清理Vite缓存：执行npx vite --clear-cache，或直接删除项目根目录下的.vite文件夹（若存在）
  • 若之前误缓存了忽略文件，执行以下命令重置Git缓存：

    git rm -r --cached .
    git add .
    git commit -m "Fix gitignore rules"
    

  之后重新安装依赖并启动项目。

• 检查版本兼容性
  确认Quasar CLI与Vite、vite-plugin-checker的版本是否匹配，部分版本组合在Git仓库环境下可能存在插件加载Bug。尝试升级相关依赖：

  npm install -g @quasar/cli@latest
  npm update @quasar/app-vite vite-plugin-checker
  

• 检查Git Hooks
  查看仓库.git/hooks目录下是否存在post-checkout、post-clone等钩子脚本，这些脚本可能修改了依赖或配置文件导致异常。暂时禁用可疑脚本后测试项目启动。

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