生产环境部分页面无样式，主因是content配置未覆盖对应源码路径；需显式添加public/html、next.js app/目录、laravel blade等路径，确保大小写和斜杠与磁盘一致，并验证动态组件及safelist正则是否完备。
生产环境只有部分页面无样式，基本可以断定是 content 配置没覆盖到那些页面的源码路径——Tailwind 不会猜你写了什么 class，只按你给的 glob 字符串去硬盘上硬扫，漏一个文件，里面所有 class 就全丢。
检查 content 数组是否遗漏特定页面类型
很多项目把静态 HTML 页面（比如 public/404.html、public/index.html）或服务端渲染模板（如 Laravel 的 resources/views/*.blade.php、Next.js 的 app/**/*.tsx）放在非标准目录，但 content 里只写了 "./src/**/*.{js,ts,jsx,tsx}"，结果这些页面里的 class="text-center" 直接被 PurgeCSS 当“死代码”删掉。
- 静态 HTML 必须显式加入：
"./public/**/*.html" - Laravel Blade 模板要加：
"./resources/views/**/*.blade.php" - Next.js App Router 页面：
"./app/**/*.{ts,tsx,js,jsx}"（注意不是pages/） - 路径大小写必须和磁盘一致：Windows 下
.tsx写成.TSX就不匹配 - 斜杠统一用
/，避免 Windows 的\被转义
确认动态加载的页面是否被扫描到
通过 Axios、SWR 或客户端路由（如 React Router）异步加载的模态框、弹窗、Tab 内容等，其 HTML 模板如果存在独立文件（比如 modals/CreateModal.tsx），而 content 没包含这个路径，那里面写的 class="bg-blue-500" 在构建时根本不会生成 CSS 规则。
- 检查这些组件是否在
contentglob 范围内，尤其是嵌套层级深的目录 - 若用
import.meta.glob或require.context动态导入，glob 表达式本身不会被 Tailwind 扫描，必须手动把目标路径加进content - 第三方 UI 库（如 DaisyUI）若以源码形式引入，也要列进
content，例如："./node_modules/daisyui/dist/**/*.js"
验证 safelist 是否覆盖了运行时拼接的 class
部分页面用了 JS 动态拼 class，比如 className={`p-${size} ${theme}-text`}，而 size 和 theme 来自 props 或 API 响应——这种字符串在源码里根本没完整出现过，PurgeCSS 看不到，就不会保留对应规则。
- 硬编码高频组合：
safelist: ['p-4', 'p-6', 'dark-text', 'light-text'] - 正则必须用斜杠包裹，不能加引号：
{ pattern: /p-(4|6|8)/ }，而不是"p-(4|6|8)" - 响应式前缀要显式写进去：
/^(md|lg):p-(4|6)$/，否则md:p-4会被删 - 避免
/p-.*/这类宽泛正则，可能意外保留place-items这类原生属性
绕过框架封装，单独测试 Tailwind CLI 扫描效果
有些构建脚本（比如自定义 Webpack 或 CI 中的 npx tailwindcss -i ...）漏传 --content 参数，或者传错路径，导致实际构建时根本没扫你的页面文件。这时候靠看框架日志没用，得直接测 CLI。
- 临时注释掉
tailwind.config.js中的content字段，运行构建：如果所有页面样式都回来了，就是content配置问题 - 用 CLI 单独跑一次：
npx tailwindcss -i ./src/input.css -o ./dist/output.css --minify --content "./public/**/*.html" --content "./src/**/*.{tsx,ts}" - 路径含空格时，每个
--content值必须单独双引号包裹，不能合并 - CI 中 pwd 不是项目根目录？改用绝对路径：
--content "$PWD/public/**/*.html"
最容易被忽略的一点：Tailwind 扫描的是源码里的字面量字符串，不是 DOM 渲染结果。你在浏览器里看到 class="text-red-500"，不代表它一定存在于最终 CSS 文件里——它可能压根没被扫描到，也没被 safelist 捕获。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
