npm install依赖冲突：如何在根项目安装Vite ^6.2.4？

是否需要更换Node.js/NPM版本？ #

不需要。问题核心是Vite版本与@vitejs/plugin-vue的peer依赖不匹配，和Node.js/NPM版本无关，无需更换。

修复方案 #

方案1：降级Vite到插件支持的版本（推荐）

这是最稳妥的方式，让Vite版本符合插件的peer依赖要求：

• 卸载当前高版本Vite：

  npm uninstall vite
  

• 安装兼容的Vite版本（比如最新的5.x系列）：

  npm install vite@^5.0.0 --save-dev
  

  也可以指定具体版本（如vite@5.2.8），只要版本在^4.0.0 || ^5.0.0范围内即可。

方案2：升级@vitejs/plugin-vue到支持Vite 6.x的版本

如果想保留Vite 6.x，可尝试升级插件到适配版本：

• 卸载旧版插件：

  npm uninstall @vitejs/plugin-vue
  

• 安装最新版插件（需确认其peer依赖已支持Vite 6.x）：

  npm install @vitejs/plugin-vue@latest --save-dev
  

  注：如果插件尚未发布适配Vite 6的版本，此方案不可行，优先选方案1。

方案3：临时跳过peer依赖检查（不推荐）

仅作为临时应急方案，可能引发运行时兼容性问题：

• 执行安装时添加参数：

  npm install --legacy-peer-deps
  

• 或者在项目的package.json中配置永久开启该选项：

  "npmConfig": {
    "legacy-peer-deps": true
  }
  

问题原因 #

@vitejs/plugin-vue@4.6.2的peer依赖明确要求Vite版本在^4.0.0 || ^5.0.0范围内，但你当前项目安装了Vite@6.2.5，超出了这个范围，npm的依赖解析机制为了避免潜在兼容性问题，抛出了ERESOLVE错误。

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