PurgeCSS仅扫描content配置的源码文件，不处理API响应或SSR生成的HTML；服务端模板类名须显式加入content路径，动态类名需用正则safelist精确匹配，Tailwind用户应统一使用其content配置。
content 配置必须覆盖服务端模板文件
PurgeCSS 不会读取 API 响应或 SSR 渲染后的 HTML，它只扫描你 content 数组里列出的源码文件。如果你的服务端返回的类名（如 class="user-status-{{ status }}"）写在 EJS、Nunjucks、PHP 模板或后端渲染的 HTML 中，而这些文件没被 content 包含，PurgeCSS 就当它们不存在——直接删掉对应 CSS 规则。
常见错误是只配了 ./src/**/*.{js,jsx,ts,tsx,vue}，却漏掉 ./views/**/*.ejs 或 ./templates/**/*.html。
- 用绝对路径：避免
./views/**/*.ejs在 Windows 下失效，改用path.join(__dirname, 'views', '**', '*.ejs') - 确认模板中类名是字面量：
class="status-"这种写法仍会被 PurgeCSS 忽略，因为它看到的是status-<%= user.status %>字符串，不是status-active；必须改成class="status-active status-pending status-error"全量写出，或靠safelist补救 - 若用 Next.js / Nuxt 等框架，SSR 生成的 HTML 不参与 PurgeCSS 扫描，动态类必须进
safelist
safelist 必须匹配最终渲染出的完整类名
服务端返回的类名（如 role-admin、theme-dark、lang-zh-CN）通常带变量或枚举值，PurgeCSS 不会运行后端逻辑去展开它们。你得用正则主动告诉它：“这些模式我全都要保留”。
错误写法：/^role-.*/ —— 可能意外保留 role-button（原生 ARIA 属性）或第三方库的 role-modal；'role-admin' —— 只保一个，漏掉 role-user 和 role-guest。
立即学习“前端免费学习笔记（深入）”；
- 收敛范围：
/^role-(admin|user|guest)$/、/^theme-(light|dark|auto)$/ - 支持多级嵌套：
/^(?:lang|region)-[a-z]{2}(?:-[A-Z]{2})?$/（匹配lang-en、lang-zh-CN、region-US） - 若类名来自数据库字段（如
user.tag），且值不可穷举，只能加通配前缀：'tag-' + tag→ safelist 写/^tag-/，但要接受潜在误留风险
避免 JS 注入类名绕过 PurgeCSS 扫描
有些项目在客户端 JS 里根据服务端响应动态加 class：el.classList.add('status-' + data.status)。这种写法完全逃过 PurgeCSS 的字符串扫描，哪怕 data.status 是固定枚举，也不会被识别。
- 别依赖运行时拼接：把所有可能值提前写死在模板或配置里，例如定义常量
const STATUS_CLASSES = ['status-active', 'status-pending', 'status-error']，并在任意 JS/TS 文件中引用它（确保该文件在content路径内） - 或直接将这些类名加进
safelist字符串数组：['status-active', 'status-pending', 'status-error'] - 若用 React/Vue，
className={`status-${status}`}同样无效，必须走正则或全量 safelist
Tailwind 用户请用内置 content 配置，别混用插件
如果你项目已用 Tailwind v3+，tailwind.config.js 中的 content 字段会自动接管 PurgeCSS 行为。此时再在 postcss.config.js 里手动加 @fullhuman/postcss-purgecss，不仅多余，还会因插件顺序冲突导致类名被删两次，或扫描范围错乱。
- 删掉
postcss.config.js中所有 PurgeCSS 相关插件 - 在
tailwind.config.js的content里显式加入服务端模板路径：content: ['./src/**/*.{js,ts,jsx,tsx}', './views/**/*.ejs', './templates/**/*.html'] - 注意：Tailwind v3.3+ 支持自定义提取器，对
<% %>类模板语法兼容更好，旧版建议升级
user.css_class 字段，它只存在于运行时内存，PurgeCSS 永远看不到。这种场景下，safelist 不是可选项，是唯一解。 
