生产环境样式丢失主因是content配置未覆盖所有含类名文件；Tailwind v3+仅扫描content数组指定路径的源码字符串，漏路径即删样式，需显式包含TSX、Vue、HTML、node_modules等路径，并正确传递--content参数。
生产环境样式丢失，八成是 Tailwind 的 content 扫描没覆盖到你实际写 class 的地方——它只看源码字符串，不执行 JS，也不解析 import，漏配路径或动态 class 就直接删掉对应 CSS。
检查 tailwind.config.js 的 content 数组是否覆盖所有含 class 的文件
Tailwind v3+ 完全依赖 content 字段扫描源码，不再读 purge，也不会自动推导。漏掉一个扩展名或目录，对应 class 就进不了最终 CSS。
- 写了
"./src/**/*.{js,ts}"，但组件是.tsx或.vue？必须显式加上tsx和vue - 用了
public/index.html写静态 class？得加进content，比如"./public/**/*.html" - 第三方 UI 库（如 DaisyUI、Flowbite）的组件文件在
node_modules里？手动列进去，例如"./node_modules/daisyui/dist/**/*.js" - 路径大小写、斜杠方向、
**和*层级必须和磁盘上完全一致；Windows 下统一用/更稳
动态拼接的 class（如 text-${color}-500）必须进 safelist
PurgeCSS 匹配的是源码里的字面量字符串，不是运行时拼出来的结果。JSX 中 className={`bg-${theme}-500`} 这种写法，源码里根本没出现完整类名，必然被删。
- 简单场景：硬编码
safelist: ['bg-red-500', 'text-blue-600'] - 多变体推荐正则：
{ pattern: /text-(red|blue|green)-(500|600)/ } - 响应式前缀要显式包含：
/^(md|lg):text-(red|blue)-500$/，只写text-red-500会漏掉md:text-red-500 - 避免
.*结尾：/text-.*/会意外匹配text-clip这类原生属性
使用 @apply 的自定义样式必须包裹在 @layer components 里
开发环境正常、生产环境消失，大概率是你把 @apply 写在了裸 .btn-primary 规则里，没声明层级。Tailwind 的扫描器无法建立“这个 CSS 规则用了哪些工具类”的关联，就当它们没被用过，直接删掉。
立即学习“前端免费学习笔记（深入）”；
- 错误写法：
.btn-primary { @apply px-4 py-2 bg-blue-600; } - 正确写法：
@layer components { .btn-primary { @apply px-4 py-2 bg-blue-600; } } -
@layer components必须放在@tailwind components之后，且整个块应置于主 CSS 文件（如globals.css）中 - 别用
@layer utilities放组件样式——它专为工具类扩展设计，顺序和作用域都不同
构建命令里漏传 --content 参数或路径错位
如果你没走框架封装（如 Vite/Next.js 插件），而是直接调用 tailwindcss CLI，那 --content 必须显式传入，且路径必须对得上当前工作目录。
- 常见错误：
npx tailwindcss -i ./src/input.css -o ./dist/output.css --minify（缺--content） - 正确做法：把
tailwind.config.js里content数组的内容，每个字符串单独作为--content参数传入，例如：--content "./src/**/*.{js,ts,tsx}" --content "./public/**/*.html" - CI 环境 pwd 不是项目根目录？改用绝对路径：
--content "$PWD/src/**/*.{js,ts}"（Bash）或先cd到根再执行 - 路径含空格？每个
--content值必须独立双引号包裹，不能合并成一个字符串
最容易被忽略的是：PurgeCSS 只处理源码文本，不关心 JS 是否真的运行到了那行。哪怕你用 if (false) 包着动态 class，只要源码里没字面量，它就敢删——所以 safelist 和 content 覆盖，得靠人眼确认，不能靠逻辑推断。
