跳到主要内容

CLI

可通过命令行界面来使用 PurgeCSS。你可以单独使用其 CLI 或与配置文件一起使用。

安装​

你可以将 PurgeCSS 安装为 dev 依赖项并利用 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​

你可以使用文件名或 globs 数组来指定由 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 选择器，可以在 safelist 参数中指定。

purgecss --css css/app.css --content src/index.html --safelist classnameToSafelist