根本原因是Tailwind默认生成全量CSS，解决方法是配置content字段精确扫描模板路径并启用JIT模式，同时用safelist处理动态类名，确保只生成实际使用的样式。
Tailwind CSS 的首屏加载慢，根本原因不是它“重”，而是默认生成了全量 CSS —— 你只用了 text-sm 和 bg-blue-500，它却把 text-9xl、bg-rose-900 到 drop-shadow-2xl 全塞进一个 CSS 文件里。解决方法只有一个：让 Tailwind **只生成你 HTML 中真实出现过的类**。这靠的不是魔法，是 content 配置 + JIT 模式。
tailwind.config.js 的 content 字段必须精确覆盖所有模板路径
这是整个按需打包的起点。Tailwind 不会自动猜你写了哪些类，它只扫描 content 列表里指定的文件。漏掉一个 Django 模板、一个 Vue 组件、甚至一个 JS 文件里的字符串拼接类名（如 `text-${size}-sm`），对应样式就会被 Purge 掉或压根不生成。
- ✅ 正确示例（Django 项目）：
content: ["./templates/**/*.html", "./**/*.py", "./static/js/**/*.js"] - ❌ 常见错误：只写
["./src/**/*.{html,js,ts}"]，但你的 Django 模板在./templates/下，结果所有class="..."全失效 - ⚠️ 注意：路径通配符必须用双引号包裹，且不能省略扩展名；Vite 或 Next.js 项目还要加上
.tsx、.vue等
JIT 模式必须启用，且不能和旧版 purge 配置混用
从 Tailwind v3.0 起，JIT 是默认模式，但如果你的 tailwind.config.js 里还留着 purge: [...] 字段，Vite 或 Webpack 构建时会报错或降级回传统编译，导致体积爆炸。
- ✅ 正确配置：
mode: "jit"可以删掉（v3.0+ 默认开启），重点是彻底移除purge字段 - ✅ 同时确保
content存在且非空，否则 JIT 无法工作 - ❌ 错误组合：
mode: "jit"+purge: [...]→ 构建失败或忽略 JIT
动态类名（如字符串拼接）必须显式声明
Tailwind 扫描的是静态文本，class="text-${color}-500" 这种模板字符串它看不到。不处理的话，text-red-500、text-blue-500 全部丢失。
立即学习“前端免费学习笔记（深入）”；
- ✅ 解决方案一（推荐）：用
safelist显式保留可能用到的组合：safelist: [/^text-(red|blue|green)-500$/, /^bg-(white|black)$/] - ✅ 解决方案二：改用
@apply封装，把动态逻辑移到 CSS 层：.btn-red { @apply text-red-500 bg-red-100; } - ⚠️ 注意：
safelist是正则数组，不是字符串数组；过度使用会抵消按需打包效果
生产构建后务必验证 CSS 是否真被裁剪
配置写对了不代表生效。最直接的验证方式是构建后打开生成的 CSS 文件，搜 text-4xl 或 bg-gradient-to-r —— 如果这些你根本没用过的类还存在，说明 content 扫描路径有遗漏，或项目里有未识别的动态类名。
- ✅ 快速检查：用
npx tailwindcss -i ./src/input.css -o ./dist/output.css --minify手动触发一次构建，观察输出体积（应远小于 3MB） - ✅ 浏览器验证：打开 DevTools → Elements → 查看任意元素的 computed styles，确认 class 对应的样式确实存在，而非被 Purge 掉
- ⚠️ 容易被忽略的点：Django 的
{% static %}模板标签、Vue 的v-bind:class动态对象、JSX 中的条件 class（如className={isActive ? "bg-blue-500" : "bg-gray-200"}）都必须被content覆盖到
