用途：在 Vite 项目中接入 Tailwind CSS，并区分 v4 与 v3 两条互不相同的集成路径。
主要能力：v4 使用专用 @tailwindcss/vite 插件（推荐），安装 npm install tailwindcss @tailwindcss/vite，在 vite.config.ts 的 plugins 中加入 tailwindcss()，入口 CSS 写 @import "tailwindcss";，无需 tailwind.config.js，v4 会依据 .gitignore 与扫描启发式自动检测模板文件。v3 使用 PostCSS 管线，安装 npm install -D tailwindcss@3 postcss autoprefixer 并执行 npx tailwindcss init -p，在 tailwind.config.js 的 content 中列出所有模板扩展名，入口 CSS 写 @tailwind base; @tailwind components; @tailwind utilities;。
使用方式：始终让插件与版本匹配，v4 用 @tailwindcss/vite，v3 用 tailwindcss PostCSS 插件；框架项目（React、Vue、Svelte、SolidJS、Qwik）把 tailwindcss() 加入 plugins 数组，框架自带 CSS 预处理器时保持框架插件在前。Monorepo 中 v3 扩展 content 路径，v4 用 @source 指令引入 Vite 根目录之外或未被扫描的包。
适用场景：Vite 项目的 Tailwind 接入、版本迁移、Monorepo 与库模式、SSR、HMR 设计令牌更新。
限制与注意：不要同时安装 @tailwindcss/vite 与 @tailwindcss/postcss；v4 入口不要写 @tailwind 指令，v3 入口不要写 @import "tailwindcss"；v4 不要用 tailwind.config.js 配置 content；不要设置 optimizeDeps.exclude: ["tailwindcss"]。类名由字符串拼接生成时 JIT 扫描不到，需用 safelist（v3）或 @source inline（v4）。已知 v4.0.8 与 Astro 存在回归，可固定 4.0.7 或升级到修复版本；Turbopack 任意值缺失问题不影响 Vite。验证可用 <div class="text-3xl font-bold underline"> 检查链路是否生效。