Tailwind CSS 构建变慢主因是配置失控：content路径过宽、插件冗余、theme.extend过度扩展，导致JIT/Oxide引擎重复扫描与解析；需精准限定content、启用Oxide、精简插件与变体、排除无关文件并验证实际扫描范围。
Tailwind CSS 构建变慢，90% 的情况不是版本升级导致的“性能倒退”，而是配置在迭代中逐渐失控：content 路径越扩越宽、插件越加越多、theme.extend 越堆越厚，最终让 JIT（或 v4 Oxide）引擎反复扫描、重复解析、过度生成。
content 路径写太宽，I/O 直接拖垮构建
Tailwind 会真实读取 content 数组里每个 glob 匹配到的文件，逐行正则提取类名。路径一松，就可能扫进 node_modules、.git、dist/、src/assets/icon.svg、甚至 src/data/config.json——这些文件既不含类名，又强制触发 I/O 和字符串匹配。
- ❌ 错误写法：
["./**/*"]或["./src/**/*"]—— 匹配一切，包括构建产物和文档 - ✅ 推荐写法：
["./src/**/*.{ts,tsx,js,jsx}", "./public/**/*.html"]，Vue/Svelte 项目必须显式加上.vue或.svelte - 可加排除项：
["./src/**/*.{ts,tsx}", "!./src/**/*.test.{ts,tsx}", "!./src/**/docs/*.md"] - 验证方式：
npx tailwindcss --watch --verbose，看终端输出实际扫描了哪些文件
v4 Oxide 引擎没真正启用，还在跑 JS 版本
v4 默认用 Rust 编写的 Oxide 引擎，但只要配置稍有偏差，就会自动 fallback 到旧版 JS 实现——性能直接打五折，且无任何警告。
- 必须确认：
npx tailwindcss -v输出是v4.x.x，且启动时终端出现Using Oxide engine - 删掉残留包：
npm rm @tailwindcss/jit（v4 已完全移除） - PostCSS 配置别乱动：
postcss.config.js中不能把cssnano放在tailwindcss前面，否则 Oxide 被绕过 - Vite 用户请换用
@tailwindcss/vite插件，它自动注入 Oxide 并跳过 JS fallback
插件和变体开太多，Oxide 白快了
Oxide 加速的是“按需生成”，但它无法跳过你主动要求生成的内容。每个开启的插件、每种变体、每个 theme.extend 的值，都会参与组合爆炸计算。
立即学习“前端免费学习笔记（深入）”；
- 关掉不用的 corePlugins：
corePlugins: { float: false, appearance: false, objectFit: false } - 收缩变体范围：
plugins: [require('@tailwindcss/forms')]是 OK 的，但别全局开hover:focus:active:disabled所有状态 - 颜色/间距只 extend 实际用到的：
theme.extend.colors: { primary: colors.blue }，别导入全集colors - 避免在
theme.extend.spacing里塞几十个自定义值——每个都乘以所有变体，体积和编译时间指数增长
开发时 watch 模式被干扰，反复全量重建
看起来是“构建慢”，其实是每次保存都触发完整重生成——根本不是 JIT 在工作，而是监听逻辑失效或环境变量错位。
- 确保
NODE_ENV=development，并显式设TAILWIND_MODE=watch（如："dev": "TAILWIND_MODE=watch NODE_ENV=development vite"） - Next.js 项目删掉根目录的
postcss.config.js——它大概率覆盖了默认插件顺序，禁用 JIT 自动推导 - Vite 首次加载慢？检查
vite.config.ts的optimizeDeps.include是否包含['tailwindcss', 'postcss']，否则预构建跳过它，浏览器边请求边编译 - 动态类名（如
className={`text-${size}-500`}）未加safelist，JIT 扫不到，结果 fallback 到全量生成来保底
最常被忽略的点：你以为改了配置就生效，但 Tailwind 不会告诉你哪条 content 路径根本没匹配到任何文件，也不会提示 theme.extend 里某个颜色值让生成耗时多出 800ms——它只是默默变慢，直到你运行 --verbose 看到那几百个 SVG 和 JSON 文件正被逐个打开。
