CLI

PurgeCSS 可通过命令行界面获得。你可以单独使用 CLI,也可以与配置文件一起使用。

安装

你可以将 PurgeCSS 安装为开发依赖项,并使用 npx 使用 CLI,也可以全局安装 PurgeCSS

npm i -g purgecss

用法

要查看 CLI 的可用选项:purgecss --help

Usage: purgecss --css <css...> --content <content...> [options]

Remove unused css selectors

Options:
  -V, --version                        output the version number
  -con, --content <files...>           glob of content files
  -css, --css <files...>               glob of css files
  -c, --config <path>                  path to the configuration file
  -o, --output <path>                  file path directory to write purged css files to
  -font, --font-face                   option to remove unused font-faces
  -keyframes, --keyframes              option to remove unused keyframes
  -v, --variables                      option to remove unused variables
  -rejected, --rejected                option to output rejected selectors
  -rejected-css, --rejected-css        option to output rejected css
  -s, --safelist <list...>             list of classes that should not be removed
  -b, --blocklist <list...>            list of selectors that should be removed
  -k, --skippedContentGlobs <list...>  list of glob patterns for folders/files that should not be scanned
  -h, --help                           display help for command

通过 CLI 可用的选项与通过配置文件可用的选项类似。你还可以将 CLI 与配置文件一起使用。

--css

purgecss --css css/app.css css/palette.css --content src/index.html

--content

你可以使用文件名或glob在新窗口中打开数组指定应由 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