报错:Error: @vitejs/plugin-vue requires vue (>=3.2.13) or @vue/compiler-sfc to be present in the depen

本文讲述了作者在尝试运行从GitHub克隆的wujie微前端项目时遇到的错误,经过升级Vue版本、删除node_modules并重新安装、以及最终通过切换到最新Node版本20.11.1解决了问题。

从github下clone了一个wujie微前端演示项目,下载到本地运行不起来,报如下错误:

Error: @vitejs/plugin-vue requires vue (>=3.2.13) or @vue/compiler-sfc to be present in the dependency tree.

解决步骤

一、升级VUE版本

看字面意思这个报错应该是说vue版本不正确导致的,于是安装了最新版的vue,结果还是无果。

二、重新下载@vue/compiler-sfc

上网查询相关报错的解决方法,有人说是这个插件版本不正确导致,于是卸载重装,还是没有解决。

三、删除node_nodules重新npm install

有的说建议删掉node_modules,清除缓存后重新下载。依然没用。

四、使用nvm切换Node为最新版本(成功解决)

stackoverflow上有人对这个报错进行了提问,下面有回答说可能是node版本导致,突然想起来我们公司这个项目因为年代比较久远使用了比较老的node版本,然后使用nvm切换为20.11.1后成功运行!

在使用 Vite 构建 Vue 项目时,遇到 `@vitejs/plugin-vue` 插件报错提示 `requires vue (>=3.2.13) or @vue/compiler-sfc`,通常与项目依赖配置、Vue 版本、构建工具兼容性或 Node.js 环境有关。以下是几种常见解决方案及操作建议: ### 1. 确保正确安装 Vue@vue/compiler-sfc 该错误通常表明项目中缺少 `vue` 或 `@vue/compiler-sfc` 依赖。可以尝试以下命令之一或组合使用: - 安装指定版本的 Vue: ```bash npm install vue@3.2.13 --save-dev ``` 安装完成后,确保版本符合插件要求,可通过 `npm list vue` 检查当前项目中 Vue 的版本 [^3]。 - 单独安装 `@vue/compiler-sfc`: ```bash npm install @vue/compiler-sfc --save-dev ``` 该包是 Vue 单文件组件编译器,Vite 在构建过程中依赖它进行模板解析 [^1]。 ### 2. 检查依赖树完整性 有时依赖项虽然已安装,但可能未正确出现在 `package.json` 中或未被正确解析。可以通过以下方式修复依赖树: - 删除 `node_modules` 和 `package-lock.json`: ```bash rm -rf node_modules package-lock.json ``` - 重新安装依赖: ```bash npm install ``` 这将确保所有依赖项按照 `package.json` 中的声明重新安装,并重建依赖树 [^3]。 ### 3. 检查 Node.js 版本 Node.js 环境版本过低可能导致兼容性问题。Vite 和 Vue 3 需要较新的 Node.js 版本支持。可以使用 `nvm`(Node Version Manager)切换 Node.js 版本,例如切换到 `20.11.1`: ```bash nvm install 20.11.1 nvm use 20.11.1 ``` 切换后再次运行项目,观察是否仍然报错 [^5]。 ### 4. 检查项目配置文件及模板语法 某些项目模板中可能包含特定语言或样式处理器的配置(如 `lang="scss"`),若未正确配置相关依赖(如 `sass-loader` 或 `postcss`),也可能间接导致构建失败。可以尝试以下操作: - 删除模板中的 `lang="scss"` 属性,确保项目能正常启动: ```html <style scoped> /* 原来为 <style lang="scss" scoped> */ </style> ``` - 后续再逐步添加样式处理器依赖,确保每一步都能正常运行 [^4]。 ### 5. 升级或降级 Vite 及相关插件 如果上述方法仍无法解决问题,可能是 `vite` 或 `@vitejs/plugin-vue` 版本与当前 Vue 版本不兼容。可以尝试升级或降级相关依赖版本: - 查看当前版本: ```bash npm list vite @vitejs/plugin-vue ``` - 升级或降级到兼容版本: ```bash npm install vite@latest @vitejs/plugin-vue@latest --save-dev ``` 或者指定特定版本号进行安装 [^2]。 ### 6. 使用 Vue CLI 替代 Vite 若项目对构建工具没有强依赖,可以尝试使用 Vue CLI 创建项目并迁移代码,以验证是否为 Vite 相关配置问题: ```bash vue create my-project cd my-project npm run serve ``` ###
评论 4
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值