Tailwind CSS 生成全量CSS主因是content配置失效导致JIT退化：路径漏写、前缀错误、未覆盖SSR/静态模板等均会触发，需验证扫描是否真实生效并检查safelist正则精度。
Tailwind CSS 生成的 CSS 文件里塞满无用类，99% 是因为 content 字段没生效或配置错误，导致 JIT 模式退化为全量输出——它不报错，只是安静地保留全部 3000+ 工具类。
检查 content 路径是否真实覆盖所有含 className 的文件
路径漏写、带 ./ 前缀、未覆盖 SSR/静态生成模板，都会让 JIT 扫描失效：
- Next.js 必须同时包含
app/**/*.{js,ts,jsx,tsx}和pages/**/*.{js,ts,jsx,tsx}，漏掉任一，dark:、group-类大概率消失 -
./src/**/*.{js,ts}会漏掉.jsx和.tsx；单写src/App.tsx则子组件里的text-red-500根本不会被识别 -
./src/**这种带点前缀的写法，在 Vite/Next.js 中解析不一致，SSR 场景下容易跳过app/layout.tsx或data/**/*.mdx - SSR 或静态生成用的模板（如
views/**/*.html.ejs、content/**/*.mdx）也得加进content，否则服务端渲染出的 class 会被当“死代码”删掉
验证 JIT 是否真在扫描，而不是假装工作
开发服务器（npm run dev）是 JIT 实时编译，完全不依赖 content 扫描，也不触发 tree-shaking。你看到的 2MB+ CSS 只是内存快照，不是交付物。
- 必须强制走生产流程：
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" ./src/**/* | wc -lvsgrep -o "text-lg" ./dist/output.css | wc -l，若后者显著更少，说明裁剪生效
排查动态类名是否被误删
Tailwind 不执行 JS，只匹配源码中出现的字面量字符串。变量拼接类名（如 text-${color}-500）在构建时无法推断，不显式兜底就等于主动放弃样式。
立即学习“前端免费学习笔记（深入）”；
- 优先改用
@apply封装：在.btn-error { @apply text-red-500; }中定义，再把该 CSS 文件路径加进content - 必须用动态拼接时，在
tailwind.config.js的safelist里写精确正则，例如/^text-(red|blue|green)-500$/，结尾加$防止误匹配text-red-5000 - 避免
/^text-/这种宽泛正则——它会保住全部text-类，体积直接反弹 -
md:text-lg和text-lg是两个独立类，safelist里只写后者，前者仍会被删
真正难的不是定位哪一行配置错了，而是当 content 路径看似正确、safelist 也写了正则、构建命令也加了 --minify，却依然输出全量 CSS 时——那大概率是某处路径在文件系统里根本不存在，或者构建工具（比如 Vite 插件链）悄悄跳过了你写的 content 配置。这时候别猜，直接查 dist/output.css 文件本身，看里面有没有你亲手写的那个 bg-hotpink。
