tailwind生产环境样式丢失主因是content路径未覆盖实际源码文件,v3+仅扫描content数组中显式声明的glob路径,漏后缀(如.tsx/.vue)、目录或大小写不一致均导致类名被删;动态class须进safelist,@apply需置于@layer components内,cli构建必须显式传--content参数。

content路径没覆盖到实际源码文件
构建后样式丢失,大概率是Tailwind根本没扫描到你写class的地方。v3+完全靠content数组里的glob路径读源码字符串,漏一个后缀或目录,对应类就进不了最终CSS。
- 写了
"./src/**/*.{js,ts}",但组件是.tsx或.vue?必须显式加上:"./src/**/*.{js,jsx,ts,tsx,vue}" - 用了
public/index.html写静态class?得加进content:"./public/**/*.html" - 第三方UI库(如DaisyUI)的JS在
node_modules里?手动列进去:"./node_modules/daisyui/dist/**/*.js" - 路径大小写、斜杠方向、
**层级必须和磁盘上完全一致;Windows下统一用/更稳
动态class没进safelist被PurgeCSS删了
className={`text-${color}-500`}这类写法,构建时源码里没有完整类名,PurgeCSS只认字面量,不执行JS,自然不生成对应CSS。
- 高频组合建议预定义对象:
const textClasses = { primary: 'text-blue-500', danger: 'text-red-500' } - 必须用动态拼接?加
safelist显式声明:safelist: ['text-blue-500', /text-[a-z]+-500/](注意正则用斜杠包裹,不是字符串) - 响应式前缀要显式包含:
/^(md|lg):text-(red|blue)-500$/,只写text-red-500会漏掉md:text-red-500 - 避免
.*结尾:/text-.*/可能意外匹配text-clip这类原生属性
@apply写错@layer层级
开发环境正常、生产环境消失,大概率是你把@apply写在了裸CSS规则里,没声明层级。Tailwind扫描器无法建立“这个规则用了哪些工具类”的关联,直接当它没被用过,整块删掉。
- 错误写法:
.btn-primary { @apply px-4 py-2 bg-blue-600; } - 正确写法:
@layer components { .btn-primary { @apply px-4 py-2 bg-blue-600; } } -
@layer components必须放在@tailwind components之后,且整个块应置于主CSS文件(如globals.css)中 - 别用
@layer utilities放组件样式——它专为工具类扩展设计,顺序和作用域都不同
Vite插件链没生效或CLI命令漏--content
如果你没走Vite封装,而是直接调用tailwindcss CLI,那命令里没写--content就等于没配置扫描路径——v3+不再自动推导,也不读purge字段。
- 常见错误写法:
npx tailwindcss -i ./src/input.css -o ./dist/output.css --minify(缺--content) - 正确做法:把
tailwind.config.js里content数组的内容,原样塞进命令,每个路径单独传:--content "./src/**/*.{js,jsx,ts,tsx}" --content "./public/**/*.html" - 路径含空格或特殊字符时,每个
--content值必须单独用双引号包裹;不要合并成一个字符串 - CI/CD里pwd不是项目根目录?改用绝对路径:
--content "$PWD/src/**/*.{js,ts,jsx,tsx}"(Bash)
import.meta.glob动态导入模块,只要路径没显式列在content里,里面写的class照样被删。没有魔法,只有显式声明。前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











