@apply在中不生效,因Tailwind JIT仅扫描content配置路径内的文件,而scoped样式为运行时注入字符串;必须置于全局CSS入口并用@layer components包裹。

为什么@apply在
因为 Tailwind 的 JIT 引擎只扫描 content 配置中声明的文件路径(如 src/**/*.{vue,js,ts}),而 Vue/React 单文件组件里的 <style scoped></style> 是运行时注入的字符串,根本不会被解析。你在 <style scoped></style> 里写 .btn { @apply bg-blue-500; },开发时看着正常,上线后大概率失效。
必须把所有 @apply 放在全局 CSS 入口文件(如 src/styles.css)中,并用 @layer components { } 包裹。否则 PurgeCSS 会误删,尤其在生产构建中。
- ❌ 错误:写在
<style scoped></style>或@layer utilities里 - ✅ 正确:在
src/styles.css顶层写@layer components { .btn { @apply bg-blue-500 text-white px-4 py-2; } } - ⚠️ 注意:
@layer components必须是顶层声明,不能嵌套在@media、&或其他规则内
@apply能处理hover、md:、dark:这些变体吗
能,但必须显式写出完整类名,@apply 不会自动展开或包裹媒体查询、伪类或深色模式前缀——它只是“复制粘贴”工具类到当前规则里。
比如 @apply hover:bg-blue-700 md:text-lg dark:bg-gray-800 是合法的,编译后会生成对应状态的 CSS 声明;但如果你只写 @apply text-lg,然后指望它在 md: 下自动生效,那就不会。
立即学习“前端免费学习笔记(深入)”;
- ✅ 可以:
@apply text-blue-500 hover:text-blue-700 md:text-xl dark:text-gray-200 - ❌ 无效:
@apply text-lg然后期待它响应md:断点(它不会生成@media规则) - ⚠️ 深色模式嵌套如
dark:hover:bg-gray-900可直接@apply,但不能拆成dark:@apply hover:bg-gray-900(语法非法)
哪些组合适合用@apply,哪些不该碰
@apply 不是“缩短 class 属性”的快捷键,而是为真正稳定、重复 ≥3 次、无动态逻辑的视觉单元服务的。滥用会导致调试困难、样式耦合、体积膨胀。
- ✅ 适合:
@apply font-sans leading-relaxed tracking-wide(纯静态排版基线) - ✅ 适合:
@apply p-3 bg-white rounded border border-gray-200 shadow-sm(稳定卡片基础样式,且已在至少 3 个页面中字面量一致复用) - ❌ 不该:
@apply p-4 rounded-lg my-shadow(my-shadow是自定义类,PurgeCSS 无法识别,大概率被删) - ❌ 不该:
@apply bg-${color}-500(含 JS 变量,@apply在编译期执行,无法处理运行时值) - ❌ 不该:
.card-header { @apply p-4; }+.card { @apply p-6; }(修改 header padding 会意外影响 card 的整体结构)
嵌套选择器里写@apply为什么报错
Tailwind 的 PostCSS 插件只扫描顶层规则块,即 selector { ... } 最外层大括号内的内容。@apply 出现在 @media、&、@layer 或多级选择器(如 .card .header)内部时,会被直接忽略——不是报错,是压根不处理。
v4 已彻底移除对嵌套 @apply 的实验性支持。你看到旧项目“能跑”,大概率是 v3.3 的 patch 或自定义插件在撑着,升级必崩。
- ❌ 报错:
.card { @media (min-width: 768px) { &__header { @apply text-lg; } } } - ❌ 报错:
@layer components { .btn { &:hover { @apply bg-blue-700; } } } - ✅ 替代:
@layer utilities { @media (min-width: 768px) { .card-header-md { @apply text-xl font-bold; } } } - ✅ 替代:HTML 层直接写
class="text-lg md:text-xl",把响应式逻辑留在模板中
@apply 更重要。



















