Tailwind CSS v4 默认无需 tailwind.config.js,改用 CSS-first 配置(@theme/@layer/@source);入口仅需 @import "tailwindcss";推荐 @tailwindcss/vite 插件替代 PostCSS;自动内容检测覆盖标准模板文件,自定义后缀需 @source 显式声明。

tailwind.config.js 在 v4 中不是必须的
Tailwind CSS v4 默认不再依赖 tailwind.config.js,它改用 CSS-first 配置方式:所有主题、变体、插件行为都通过 @theme、@layer、@source 等指令直接写在 CSS 文件里。如果你仍保留 tailwind.config.js,v4 会忽略它(除非你显式启用兼容模式)。而 v3 必须有该文件,否则连基础扫描路径都找不到。
@import "tailwindcss" 替代三条 @tailwind 指令
v4 的入口 CSS 文件只需一行:@import "tailwindcss";。它自动合并了 v3 中的 @tailwind base、@tailwind components、@tailwind utilities。如果还在 v4 项目里写这三行,构建会报错或静默失效——因为 v4 的引擎已不识别这些指令。
Vite 插件取代 PostCSS 配置
v4 推荐使用 @tailwindcss/vite 插件,它内置编译逻辑,不需要 postcss.config.js 或手动安装 autoprefixer。而 v3 依赖 PostCSS 生态,必须配置 postcss.config.js 并引入 tailwindcss 和 autoprefixer 两个插件。常见错误是:v4 项目里误留 postcss.config.js,导致构建重复处理或样式丢失。
自动内容检测让 content 配置消失
v4 默认自动扫描项目中所有模板类文件(.html、.vue、.jsx 等),且自动排除 .gitignore 中的路径。你几乎不用再手动写 content 字段。但 v3 必须在 tailwind.config.js 里明确声明,比如 content: ["./src/**/*.{html,js,ts,vue}"];漏配或路径错,就会出现“类写了但没生效”的典型问题。
真正容易被忽略的是:v4 的自动检测只对标准文件扩展名有效,遇到自定义后缀(如 .astro、.svelte 或小程序的 .wxml)时,仍需用 @source 显式声明,否则那些文件里的类名压根不会被提取。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











