# CLI

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

# 安装

你可以将 PurgeCSS 安装为 dev 依赖项并利用 npx 使用其 CLI 工具,也可以安装 PurgeCSS 到全局环境:

npm i -g purgecss

# 用法

如需查看 CLI 的所有参数,请运行: purgecss --help 命令

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

Options:
  -con, --content  glob of content files
  -css, --css      glob of css files
  -c, --config     path to the configuration file
  -o, --output     file path directory to write purged css files to
  -w, --whitelist  list of classes that should not be removed
  -h, --help       output usage information

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/

# --whitelist

如果要防止 PurgeCSS 删除特定的 CSS 选择器,可以将其加入白名单。

purgecss --css css/app.css --content src/index.html --whitelist classnameToWhitelist