Vite 7 搭配@tailwindcss/vite插件遇依赖冲突，如何解决？

架构老林

2026-6-12

在Vite 7环境下使用@tailwindcss/vite的解决办法

当前安装的@tailwindcss/vite@4.1.10仅兼容Vite ^5.2.0 || ^6版本，不支持最新的Vite 7.x，因此触发peer依赖冲突错误。

等待官方插件适配更新
Tailwind团队通常会跟进新Vite版本的适配，关注@tailwindcss/vite的版本发布，待其支持Vite 7后再正常安装使用。
忽略peer依赖强制安装（存在兼容性风险）
适合临时测试场景，通过npm参数跳过依赖检查：
- 强制安装命令：
```
npm install tailwindcss @tailwindcss/vite --force
```
- 采用旧版peer依赖逻辑安装：
```
npm install tailwindcss @tailwindcss/vite --legacy-peer-deps
```
注意：此方法可能导致插件功能异常，需自行验证项目运行状态。
降级Vite至兼容版本
将Vite降级到6.x版本，满足@tailwindcss/vite的peer依赖要求：
```
npm install vite@^6 --save-dev
```
降级完成后，重新执行npm install tailwindcss @tailwindcss/vite即可正常安装。