PurgeCSS 在 React 项目中易误删样式，因其仅提取字面量类名，无法识别动态拼接（如clsx、模板字符串）、data-bs-*属性及组件库生成的哈希类，需手动配置content、defaultExtractor和safelist补全。
直接用 purgecss 扫 bootstrap.min.css 或全量引入的 tailwind.css 基本无效——它压根看不到 data-bs-toggle、className={`btn-${type}`}、clsx('text-', color) 这类动态类，删完后下拉菜单打不开、响应式断点失效是常态。
为什么 PurgeCSS 在 React 项目里容易误删样式
React 的类名生成高度动态：JSX 中大量使用 className 拼接、clsx、twMerge、useTheme 返回值，甚至服务端渲染时由 props 决定类名。PurgeCSS 默认只提取字面量字符串，对以下情况完全无感：
-
className={\`d-\${show ? 'block' : 'none'}\`}→ 提取不到d-block或d-none -
className={clsx('btn', \`btn-\${variant}\`, size && \`btn-\${size}\`)}→ 只看到btn，其余全丢 -
data-bs-*属性（如data-bs-toggle="modal"）触发的 Bootstrap 样式，根本不在类名字符串里 - 组件库（如 MUI、Ant Design）内部用
makeStyles或styled生成的哈希类，源码里根本没出现过
必须补全 content 和 defaultExtractor 配置
默认 content 路径不覆盖 JSX/TSX，且不识别属性和插值，必须显式扩展：
react-modernization
下载
将 React 应用升级到最新版本，从类组件迁移到 Hooks，并采用并发特性。用于现代化改造 React 代码库、迁移到 React Hooks 或升级到最新
module.exports = {
plugins: [
require('@fullhuman/postcss-purgecss')({
content: [
'./src/**/*.{js,jsx,ts,tsx}',
'./public/**/*.html'
],
defaultExtractor: content => {
// 匹配 className="xxx"、className={...} 中的字面量
const regex = /className\s*=\s*["'\`]([^"'\`]*)["'\`]/g;
let matches = [];
let match;
while ((match = regex.exec(content)) !== null) {
matches.push(...match[1].split(/\s+/));
}
// 强制包含 data-bs-* 属性（Bootstrap 5+ 关键）
const dataBsMatches = content.match(/data-bs-[a-z-]+/g) || [];
return [...matches, ...dataBsMatches];
},
safelist: [
// 保留所有颜色/尺寸工具类（Tailwind 类）
/bg-(red|blue|green|gray)-[0-9]{2,3}/,
/text-(red|blue|green|gray)-[0-9]{2,3}/,
/p-[0-9]+/,
// 保留 JS 动态拼接的前缀
/^btn-/,
/^d-/,
/^visually-hidden$/,
// 保留伪类和状态类
/:hover$/,
/:focus$/,
/:active$/
]
})
]
};React 项目更推荐用框架感知型替代方案
对纯 React + Tailwind 项目，purgecss 是可行的，但维护成本高；若用了 MUI、Chakra 或自定义主题系统，它就力不从心了。此时应优先考虑：
立即学习“前端免费学习笔记（深入）”；
-
tailwindcss自带的content配置（v3.0+）比 PurgeCSS 更懂 JSX 插值和clsx模式，且支持apply和@layer安全剔除 -
vite-plugin-purgecss（Vite 项目）或next-purge-css（Next.js），它们在构建早期介入，能捕获更多运行时生成路径 - 放弃 CSS 工具类路线，改用 CSS-in-JS（如
@emotion/react）或 CSS Modules —— 样式天然按组件作用域隔离，tree-shaking 由打包器原生支持
真正难优化的从来不是 PurgeCSS 配置本身，而是你项目里那些藏在 useMemo 里拼接类名、在 render 函数中条件返回不同 className、或者用 styled-components + attrs 注入类的写法——这些地方，PurgeCSS 看不见，你也容易忘掉要加到 safelist 里。
