因为Tailwind v3+硬性移除purge字段，解析时直接报“Unknown option 'purge'”错误；其内置tree-shaking仅由content字段驱动，用于扫描并剔除未使用样式，不再兼容旧配置。
为什么 purge 字段在 Tailwind v3+ 中直接报错
因为从 v3.0 开始，purge 字段被**硬性移除**，不是“不推荐”，而是解析配置时会抛出明确错误：Unknown option 'purge'。Tailwind 不再接受该字段，也不做降级兼容。
根本原因是设计思路变了：旧版 PurgeCSS 是一个独立插件逻辑，需要手动声明扫描路径 + 额外配置；v3+ 把“扫描 → 匹配 → 删除”整个流程内建为 CSS 生成阶段的默认行为，仅靠 content 字段驱动，不再有中间态。
-
content不是“替代 purge 的新名字”，而是唯一入口——它既定义扫描范围，也隐式决定哪些类该保留 - 你删掉
purge却没补content，构建会成功但 CSS 体积不变（所有类全保留），因为 Tailwind 默认 fallback 到“全量输出”模式 - 如果项目还残留
purge: { enabled: false }这类写法，v3+ 会静默忽略，但不会警告，容易误以为“关掉了 tree-shaking”
content 路径没写对，为什么本地开发完全正常？
开发服务器（如 Vite、Next.js dev）用的是 JIT 模式：所有类按需实时编译，不依赖 content 扫描结果。而生产构建（npm run build）才真正走 content 驱动的裁剪流程。
这就导致一个典型盲区：你改完 content 后本地一切 OK，上线后按钮没 padding、文字没颜色、md:flex 失效——不是代码写错了，是构建时压根没扫到你写的那个组件文件。
立即学习“前端免费学习笔记（深入）”；
- 常见漏写路径：
./app/**/*.{js,ts,jsx,tsx}（Next.js App Router）、./public/**/*.html（静态 HTML 入口）、./src/pages/**/*.{vue,html}（Vue/Nuxt） - 扩展名拼错：
.tsx写成.ts，或漏了.jsx，导致 JSX 文件里的className全部失效 - glob 语法陷阱：
**/pages/*.{ts,tsx}在某些系统下匹配失败，建议拆成两行：**/pages/*.ts和**/pages/*.tsx
动态类名（如 text-${color}）为什么总被删，safelist 怎么写才不翻车
Tailwind 不执行 JS，只做字符串字面量匹配。所以 text-${color} 这种写法，除非 color 是固定字符串且出现在源码里（比如 const color = "red-500"），否则必然被当“死代码”干掉。
safelist 是兜底手段，但正则写错反而会让体积反弹甚至引入意外样式：
- 别用
/^text-/—— 它会保留全部text-类，包括你根本没用的text-clip（这是原生 CSS 属性，不是 Tailwind 类） - 优先用带边界的正则：
/^text-(red|blue|green)-(500|600)$/，响应式前缀要显式写：/^(md|lg):text-(red|blue)-500$/ - 函数式写法更可控：
{ pattern: /bg-(red|blue)-[0-9]{3}/ }，可配合variants控制是否包含 hover/focus 等变体 - 纯字符串兜底适合极少数高频类：
'bg-opacity-50'、'animate-pulse'，比正则更轻量
怎么确认 content 配置真生效了
别猜，用命令行直连验证。Tailwind CLI 支持绕过框架封装，单独测试扫描效果：
npx tailwindcss -i ./src/input.css -o ./dist/output.css --minify --content "./src/**/*.{js,jsx,ts,tsx,html}"
跑完后用 grep -c "text-lg" ./dist/output.css 对比源码中实际出现次数。如果数字明显变少，说明裁剪起效；如果几乎一样，回头查路径是否拼错、扩展名是否漏写、是否忘了加引号（"./src/**/*" 必须带引号，否则 shell 可能提前展开）。
最狠但最准的验证方式：临时注释掉 content 字段，再 build 一次。如果样式全回来了，100% 是 content 没覆盖到关键文件——这时候问题就从“怎么配”变成了“我的类到底写在哪”。
