先说一个很多人对JIT模式的理解误区:它的核心价值并非“编译更快”,而是“生成更少”。你猜怎么着?最终输出的CSS文件可以从动辄2MB直接缩到10–30KB。原理其实不复杂——JIT不会提前把所有类(比如text-xs到text-9xl、各个断点下的flex变体)一股脑全生成出来,而是老老实实去扫描你源码里真正用到的类名字面量,然后只针对这些类生成规则。简单说:你不用它,它就不出现。

JIT模式不是“编译更快”,而是“生成更少”
它真正干的事不是让编译提速,而是让最终输出的CSS文件体积骤减——从2MB降到10–30KB已成为常态。关键在于:JIT不预生成全量类库,只扫描你源码里实际出现的类名字面量,然后生成对应规则。
content配置错一个字符,JIT就退化成全量输出
这通常是体积没变小的首要原因。JIT完全依赖content数组中列出的路径去静态读取文件内容——路径遗漏、扩展名不全、带多余前缀,都会导致扫描失败,结果就是默默保留全部类,体积依然臃肿。来看几个典型案例:
content: ["./src/**/*.{js,ts}"]—— 漏了.jsx和.tsx,React组件里的className全被忽略content: ["src/App.tsx"]—— 只扫单个文件,子组件里的bg-red-500不会被捕获content: ["./src/**/*.{js,jsx,ts,tsx}"]——./前缀在Vite/Next.js中可能被跳过,统一用src/**/*.{js,jsx,ts,tsx}更稳妥- Next.js项目有个特别需要注意的地方:
app/**/*.{js,jsx,ts,tsx}和pages/**/*.{js,jsx,ts,tsx}必须同时列上,否则dark:、group-这类类大概率直接丢失
动态类名(如text-${color})根本不会被JIT捕获
JIT是静态分析工具,它不执行JS代码,更不会帮你推算变量值。它只匹配源码中已经写死的字符串,比如"text-red-500"或'bg-blue-400'。一旦写成拼接形式,这些类就直接失效。那怎么解决?
- 安全写法:
className={isActive ? "bg-blue-500" : "bg-gray-200"}—— 两个字面量都出现在源码中,能扫到 - 危险写法:
className={`p-${padding}`}或class="text-${size}"—— JIT看不到具体值,不生成任何规则 - 替代方案:优先用
@apply封装,比如.btn-primary { @apply bg-blue-500 text-white; },确保该CSS文件路径也加入content - 兜底方案:实在必须用动态拼接时,在
safelist里写精确正则,例如/^text-(red|blue|green)-500$/,避免宽泛匹配/^text-/导致全量输出
验证JIT是否真生效,不能靠本地开发服务器
npm run dev跑得顺畅不代表生产构建没问题。开发服务器走的是JIT实时供应,完全不依赖content扫描结果;只有npm run build才会真正触发裁剪逻辑。想确认有效性,必须走这三步:
- 强制走生产流程:
TAILWIND_MODE=build npx tailwindcss -i ./src/input.css -o ./dist/output.css --minify - 人工注入测试类:在某个被
content覆盖的文件里加className="bg-hotpink" - 检查输出:
grep -o "bg-hotpink" ./dist/output.css—— 若返回非空,说明JIT没跑,还在全量打包 - 对比频次:
grep -o "text-lg" ./dist/output.css | wc -l应显著少于源码中实际出现次数(比如120次→8次)
真正容易被忽视的是:JIT的有效性完全取决于你在生产构建阶段是否完成了三件事——路径全覆盖、动态类有兜底、验证走对流程。缺一不可。
