PurgeCSS能识别data-state属性名但不理解值变化，故不会删整条规则；Tailwind v3+自带Purge功能，额外安装@fullhuman/postcss-purgecss会冲突，content须用绝对路径，启用keyframes: true和fontFace: true，否则相关规则被清除。
它不是万能清道夫，对以下三类项目基本不适用或需大幅退让：
- 纯 CSS-in-JS 项目（如 Emotion、Styled Components）：PurgeCSS 只扫描 HTML/JS 字符串，而 CSS-in-JS 的样式是运行时通过 JS 函数生成并注入
style标签的，不在其 content 范围内，强行接入等于白跑 - 大量依赖
data-属性 + JS 动态控制样式的传统 jQuery 应用：比如$el.attr('data-state', 'loading')配合[data-state="loading"] { opacity: .6 }，PurgeCSS 默认不提取属性值，除非你手动加safelist: [/\[.*\]/]并确保所有可能的值都被正则覆盖——但这类应用往往值是动态拼接的，根本列不全 - 使用 Sass
@extend构建核心样式的项目（如老版 Bootstrap 4）：PurgeCSS 不解析 Sass AST，.btn-primary {@extend .btn}导致.btn类名不会出现在任何 HTML 或 JS 中，会被直接删掉，整个按钮系统崩掉
为什么 Bootstrap 项目配了 PurgeCSS 却几乎不瘦身？
常见错误现象：purgecss 运行完，.modal、.visually-hidden 全在，体积只少不到 5%。根本原因在于它根本没“看见”这些类。
- Bootstrap 的
data-bs-toggle、data-bs-target属性触发逻辑，PurgeCSS 不分析属性值语义 -
element.className = 'btn btn-' + type这类 JS 拼接，PurgeCSS 只扫字面量字符串，'btn-' + type在源码里就是两个独立 token，无法还原出btn-outline-success - Sass
@extend生成的复合选择器（如.btn.btn-outline-primary）在最终 CSS 中存在，但原始源码中无对应 class 字符串，PurgeCSS 无从关联
解决路径不是硬配 safelist，而是放弃后处理 bootstrap.min.css，改用 Sass 按需 @import，只引入实际用到的模块。
SPA 中动态 class 误删的典型表现和底线操作
常见错误现象：
立即学习“前端免费学习笔记（深入）”；
- 下拉菜单展开后样式丢失
- 模态框打开时背景遮罩无颜色
-
v-if切换后元素样式不生效
这是因为 PurgeCSS 不执行 JS，看不到 el.classList.add("is-open") 这类运行时行为。应对方式不是禁用 PurgeCSS，而是守住两条底线：
- 在
safelist中显式保留动态类前缀：ignore: [/^is-/, /^has-/, /^js-/] - 关键交互状态改用
data-属性 + 属性选择器，例如把class="panel is-open"改成data-state="open"，再写[data-state="open"] > .panel—— PurgeCSS 能识别data-state这个属性名，虽然不理解值变化，但至少不会删掉整条规则
Tailwind 项目里最常被忽略的配置陷阱
Tailwind v3+ 自带 Purge 功能，@fullhuman/postcss-purgecss 多装一个反而冲突。但即便原生方案，也容易踩坑：
-
content路径必须用绝对路径：path.join(__dirname, 'src', '**', '*.{js,ts,jsx,tsx,vue}')，写./src/**/*.vue在 Windows 下会失效 - 没开
keyframes: true和fontFace: true，@keyframes spin和@font-face规则全被清空 -
cssnano忘记关discardUnused: false，和 PurgeCSS 重复清理，导致二次误删 - 开发环境（
process.env.NODE_ENV !== 'production'）下 PurgeCSS 默认跳过，但有人误开devtool: 'source-map'，source map 内容污染类名匹配，结果上线前测试正常，上线后样式错乱
真正难的不是“怎么配”，是确认所有动态类都落在 PurgeCSS 的视野里——它不猜、不执行、不推断，只信你给它的字符串和正则。
