Tailwind CSS v4 编译提速靠 Rust 的 Oxide 引擎替代 Node.js 管线，@tailwind 指令被 @import "tailwindcss" 替代，content 配置消失但需注意扫描边界与白名单。
Tailwind CSS v4 的编译速度提升不是靠“调优”，而是靠引擎替换——Rust 写的 Oxide 引擎直接替代了 Node.js 的旧管线，增量构建压进微秒级是常态。
为什么删掉 @tailwind 指令后反而更快？
v3 依赖 PostCSS 插件逐条解析 @tailwind base、@tailwind components 等指令，每次都要走 JS AST 遍历 + 字符串拼接；v4 的 Oxide 引擎原生支持 @import "tailwindcss"，把它当作内置模块加载指令，CSS 解析、嵌套展开、前缀补全全由 Lightning CSS 一次性完成。
- 残留
@tailwind不会报错，但样式静默失效——base 层缺失，页面可能完全无样式 - 必须同步删掉
postcss.config.js中的tailwindcss()插件调用，否则插件链冲突 -
@import "tailwindcss"必须写在 CSS 入口文件（如src/index.css）最顶部，且只能出现一次
content 路径配置彻底消失，但自动扫描有边界
v4 不再需要 tailwind.config.js，也不再要求你手动声明 content 数组。Oxide 引擎默认扫描项目根目录下所有 .js、.ts、.jsx、.tsx、.vue、.svelte 文件，但不递归 node_modules 或 dist。
- 如果你的模板分散在非标准路径（比如
src/templates/*.html），需显式启用白名单：safelist: ["src/templates/**/*.html"]（写在@theme块外，CSS 文件中） - 动态类名仍不被识别：
className={`p-${size}-4`}这种模板字符串会被跳过，得改用条件表达式或safelist正则兜底 - HTML 入口（如
public/index.html）默认不扫，若里面写了 Tailwind 类，需手动加入白名单
增量构建为何能到 0.2ms？关键在变更感知快照
v3 的 JIT 是“边扫描边生成”，每次保存都重跑全量文件匹配 + 正则提取 + 哈希查重；v4 的 Oxide 首次构建后，把每个源文件的 AST 和类名引用关系固化为内存索引，后续只比对 mtime 和内容 hash，命中就跳过解析。
立即学习“前端免费学习笔记（深入）”；
- 这个机制对 HMR 极其友好：Vite / Webpack 开发服务器热更新几乎无延迟，尤其在组件库或中后台项目中体感明显
- 但注意：如果文件系统不支持精确
mtime（如某些 Docker 卷挂载、Windows WSL2 默认设置），快照可能失效，回退到较慢路径 - CI 环境中首次构建仍需完整扫描，但后续缓存复用率极高；建议在 CI 中开启
TAILWIND_CACHE_DIR指向持久化路径
真正卡住 v4 速度的，往往不是引擎本身，而是你还在用 v3 的思维写代码——比如保留 @tailwind、漏删旧插件、或误以为“零配置=不用管路径”。Oxide 很快，但它不会猜你在哪写类名。
