命令行界面
PurgeCSS 通过命令行界面(CLI)提供。你可以单独使用 CLI 或配合配置文件使用。
安装
你可以将 PurgeCSS 作为开发依赖安装并使用 npx
调用 CLI,也可以全局安装 PurgeCSS:
npm i -g purgecss
使用
要查看 CLI 的可用选项:purgecss --help
Usage: purgecss --css <css...> --content <content...> [options]
删除未使用的 CSS 选择器
选项:
-V, --version 输出版本号
-con, --content <files...> 内容文件的通配符
-css, --css <files...> CSS 文件的通配符
-c, --config <path> 配置文件路径
-o, --output <path> 写入清除后的 CSS 文件的目录路径
-font, --font-face 删除未使用的字体图标选项
-keyframes, --keyframes 删除未使用的关键帧选项
-v, --variables 删除未使用的变量选项
-rejected, --rejected 输出被删除的选择器
-rejected-css, --rejected-css 输出被删除的 CSS
-s, --safelist <list...> 不应被删除的类列表
-b, --blocklist <list...> 应被删除的选择器列表
-k, --skippedContentGlobs <list...> 不应扫描的文件夹/文件的通配符列表
-h, --help 显示命令帮助
CLI 中可用的选项与配置文件中的选项类似。你也可以将 CLI 与配置文件一起使用。
--css
purgecss --css css/app.css css/palette.css --content src/index.html
--content
你可以使用文件名或通配符数组指定 PurgeCSS 应分析的内容。这些文件可以是 HTML、Pug、Blade 等。
purgecss --css css/app.css --content src/index.html src/**/*.js
--config
你可以将 CLI 与配置文件一起使用。使用 --config
或 -c
并指定配置文件路径。
purgecss --config ./purgecss.config.js
--output
默认情况下,CLI 在控制台输出结果。如果希望将 CSS 作为文件返回,请指定写入净化后的 CSS 文件的目录。
purgecss --css css/app.css --content src/index.html "src/**/*.js" --output build/css/
--safelist
如果希望阻止 PurgeCSS 删除特定的 CSS 选择器,可以将其添加到安全列表中。
purgecss --css css/app.css --content src/index.html --safelist classnameToSafelist