Tailwind CSS 没有 v4 版本,最新稳定版仍是 v3.4.13;所谓“v4”多源于插件版本混淆、社区误读或第三方工具张冠李戴,官方从未发布或规划 v4。

Tailwind CSS 没有 v4 版本——目前(2026年6月)最新稳定版仍是 v3.4.13,官方从未发布过 v4,也未宣布任何 v4 的开发计划或 RFC。
这意味着你看到的“Tailwind CSS v4”大概率是误传、混淆,或来自非官方渠道的虚假信息(比如某些第三方 fork、营销文案、AI 生成内容,或把其他工具如 UnoCSS / Windi CSS 的特性张冠李戴)。
为什么有人误以为有 Tailwind v4?
常见混淆来源包括:
- 把
tailwindcss@latest(即 v3.x)和@tailwindcss/typography等插件的独立版本号混为一谈 - 看到社区讨论中关于“CSS-in-JS 替代方案”或“PostCSS 9 升级影响”的推测性提案,误读为正式 v4 路线图
- 将
unocss的config.ts+extract模式当成“Tailwind v4 的 CSS-first 配置”,但 UnoCSS 和 Tailwind 是不同项目,不兼容、无继承关系 - 某些构建工具(如
vite-plugin-tailwind-purge)的文档用词模糊,写成“v4-style config”,实为类比而非版本升级
Tailwind v3 真正的配置方式没变
tailwind.config.js(或 .ts)仍是唯一受支持的配置入口,且明确要求:
立即学习“前端免费学习笔记(深入)”;
- 必须导出一个对象(或异步函数),不能直接写 CSS 规则
- 所有样式扩展必须通过
theme、plugins、content等字段声明,不是靠解析 CSS 文件推导 - 所谓“CSS-first”在 Tailwind 官方语境中并不存在——它本质是 utility-first,且依赖 JIT 编译器对
content中的 class 字符串进行扫描
如果你真想用 CSS-first 工具
可以考虑替代方案,但要注意它们和 Tailwind 不互通:
-
unocss:支持uno.config.ts+ 内联/* unocss */注释,也可从 CSS 文件提取规则,但需手动启用extractor -
Windi CSS(已归档):曾支持@apply和部分 CSS 解析,但项目已停止维护 -
Vanilla Extract:用 TypeScript 写样式,编译为原子 CSS,但需要esbuild或vite插件支持,与 Tailwind class 名体系完全无关
真正容易被忽略的一点:Tailwind 的设计哲学始终是「避免运行时解析 CSS」。哪怕未来有重大版本更新,官方也极大概率会坚持基于字符串扫描的构建时策略——因为这是它实现零运行时、确定性 purging 和可靠 tree-shaking 的根基。任何声称“v4 改用 CSS-first”的说法,都绕不开这个前提,而目前没有任何迹象表明官方打算放弃它。


















