PurgeCSS中文文档网PurgeCSS中文文档网
首页
文档
API参考
GitHub
首页
文档
API参考
GitHub
  • PurgeCSS

    • 关于PurgeCSS
    • 快速开始
    • 配置
    • 命令行接口
    • 编程API
    • 安全列表
    • 提取器
  • 插件

    • PostCSS插件
    • Webpack插件
    • Gulp插件
    • Grunt插件
    • Gatsby插件
  • 指南

    • Vue
    • React
    • Next.js
    • Nuxt.js
    • Razzle
    • WordPress
    • Hugo
  • 比较
  • 常见问题

    • 如何与CSS模块一起使用
    • 如何与Ant Design一起使用

命令行界面

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
Edit this page
Prev
配置
Next
编程API