PurgeCSS 是当前最靠谱的选择,因其能静态扫描多种模板中的类名并精准剔除未使用的 Bootstrap 样式,支持主流构建工具且不依赖运行时分析。

Bootstrap 的 CSS 文件里存在大量未被页面实际使用的样式规则,直接移除它们能显著减小 CSS 体积——但不能靠手动删,必须用工具链自动化识别和剔除。
为什么 purgecss 是当前最靠谱的选择
Bootstrap 5+ 默认使用 Sass 编译,其 CSS 输出是“全量打包”的(比如 bootstrap.min.css 包含所有组件样式),而项目中往往只用到 Button、Card 和 Grid。手动删会漏、易错、不可维护;uncss 已停止维护且不支持现代构建流程;PurgeCSS 能静态扫描 HTML、JS、TS、Vue、Svelte 等模板中的类名,精准匹配 Bootstrap 中真正被引用的类(如 btn-primary、col-6),再从 CSS 中剔除其余部分。
它不依赖运行时 DOM 分析,所以能集成进构建阶段,也兼容 Vite、Webpack、Next.js 等主流工具。
- 必须启用
content配置项,明确指定哪些文件需被扫描(例如["./src/**/*.{html,js,ts,vue}"]) - Bootstrap 的动态类名(如
bg-${color})需通过safelist显式保留,否则会被误删 - 若用到了 JS 初始化的组件(如
Dropdown、Modal),它们的类名可能不在模板中硬编码,也要加进safelist
在 Vite 项目中配置 PurgeCSS(推荐 vite-plugin-purgecss)
Vite 官方生态更倾向轻量插件,vite-plugin-purgecss 比原生 purgecss 更贴合 Vite 的 CSS 处理流程(尤其配合 css.codeSplit 或 build.rollupOptions.output.manualChunks 时)。
立即学习“前端免费学习笔记(深入)”;
安装后,在 vite.config.ts 中添加:
import { defineConfig } from 'vite'
import purgecss from 'vite-plugin-purgecss'
<p>export default defineConfig({
plugins: [
purgecss({
content: ['./index.html', './src/*<em>/</em>.{vue,ts,js}'],
safelist: [
/^bg-/,
/^text-/,
/^border-/,
/^rounded/,
'active',
'show',
'dropdown-menu',
'modal-dialog'
],
// 不要删除 Bootstrap 自带的 data-bs-* 属性选择器
keyframes: true,
fontFace: true
})
]
})
注意:safelist 里的正则必须以 /^xxx/ 形式书写,不能写成字符串 "bg-*"——后者不会生效。
容易被忽略的三类残留样式
即使配置了 PurgeCSS,仍可能有冗余 CSS 残留,原因很具体:
-
data-bs-toggle、data-bs-target这类属性选择器默认不会被识别,需在purgecss配置中开启keyframes: true并确保defaultExtractor支持属性匹配(vite-plugin-purgecss 默认支持) - JS 动态插入的类(如
tooltip浮层的bs-tooltip-auto)不会出现在源码中,必须加入safelist,或改用container+template方式预定义结构 - Bootstrap 的
@layer utilities(5.3+)和自定义@layer components若未被显式 import,PurgeCSS 不会处理它们对应的 CSS,但如果你用了@import "bootstrap/scss/utilities"却没用其中任何类,这部分仍会被保留——得靠safelist控制粒度
真正难的是判断“哪些类算‘被用到’”:不是看有没有写 class="...",而是看最终 HTML 渲染结果中是否真实存在该类。动态类、服务端渲染注入、Shadow DOM 内部类,都得单独应对。别指望一次配完就一劳永逸。


















