许多开发者误以为@apply是Tailwind CSS中的代码打包利器,使用它就能有效精简代码、减小文件体积。然而实际情况恰恰相反——@apply使用得越频繁,最终生成的CSS文件反而越庞大。这并非指令本身存在问题,而是因为它绕过了PurgeCSS的按需生成机制:每写一条@apply,JIT编译器就会忠实地生成相应数量的重复底层工具类规则,即使这些类在HTML中从未出现过。

为什么过度使用@apply会导致CSS体积增大
根本原因不在于@apply本身会膨胀代码,而在于它绕过了PurgeCSS的按需生成机制——每写一条@apply,JIT就会无条件生成对应数量的重复工具类规则。举个例子:你在CSS里写@apply text-red-500 font-bold p-2;,JIT会强制生成.text-red-500、.font-bold、.p-2三条规则,即便你的HTML中从未引用过这些原子类。而PurgeCSS只识别class属性中的字符串,不会解析@apply内部的内容,因此这些规则一个都不会被清理。
@apply无法触发PurgeCSS的条件扫描
更直白地说:
- 假如你写了10个
@apply组合,每个包含5个工具类,那么JIT将输出50条独立规则 - 相比之下,如果直接在HTML中使用这50个类,PurgeCSS可能只保留其中实际出现的20个(其余从未使用)
- 若路径未正确配置进
content,那么整个.btn-primary类都不会被JIT处理,但@apply中引用的工具类仍然会全量输出
嵌套使用@apply或混入自定义类会放大体积问题
例如,你定义.btn {@apply p-2 rounded;},随后又定义.btn-primary {@apply btn bg-blue-600;},JIT并不会复用已有的.btn,而是分别生成p-2、rounded、bg-blue-600三套规则。更糟糕的是:
@apply并不支持嵌套另一个@apply,但开发者常常手动复制粘贴,导致bg-blue-600在多个位置重复生成- 混用自定义类例如
@apply p-2 my-custom-shadow;,其中my-custom-shadow不会被PurgeCSS识别,而p-2仍会照常输出 - 响应式写法如
@apply md:flex lg:justify-between会强制生成md:flex和lg:justify-between,即便项目中仅在一处使用
真正减少体积的关键在于content配置,而非@apply的数量
很多人错误地认为“将类名抽成@apply就能减小体积”,实际上只是把类名从HTML转移到了CSS中,并未减少任何实际生成的规则。关键在于content配置是否覆盖了所有真正使用类名的位置。
- 如果遗漏配置
src/components/**/*.tsx,那么在JSX中编写的class="text-lg"将不会被扫描,对应的规则依然会照常输出 - 动态拼接例如
className={`p-2 ${isActive ? 'bg-red-500' : ''}`}必须添加safelist: [/^bg-/],否则bg-red-500会直接消失 @apply中编写的hover:bg-blue-700会被生成,但若HTML中从未出现hover:前缀的类,PurgeCSS无法判断这些规则是否应该保留
真正难以优化的从来不是@apply写多写少,而是分不清哪些类名是“被代码实际调用”的,哪些是“被@apply强制引入”的——后者永远无法避免全量输出。
