隨著前端項目的不斷迭代，就可能出現部分 CSS 代碼未使用的情況。這些未使用代碼就可能影響應用性能。

那么，如何有效地刪除未使用的 CSS 代碼呢？本文將介紹一種強大的工具——PurgeCSS，它可以自動檢測和刪除未使用的 CSS 代碼。無論是在 Vue、React 還是其他前端框架中，PurgeCSS 都能輕松集成。

接下來，讓我們一起探索如何配置和使用 PurgeCSS，以及一些高級配置選項，幫助我們根據項目需求定制刪除未使用的 CSS 代碼的過程！

未使用的 CSS

使用 Chrome 瀏覽器的 Coverage 面板，就可以看到當前頁面所有CSS 文件的使用情況（打開Coverage面板方式：Ctrl+Shift+P，搜索 Coverage）：

這里顯示了每個文件的總大小、未使用的CSS 的大小、未使用的 CSS 所占比例。可以看到，文件中未使用的 CSS 占大多數。

點開一個文件，就可以看到這個文件中有哪些樣式使用了（藍色），有哪些樣式未使用（紅色）：

默認情況下，瀏覽器必須下載、解析和處理它遇到的所有外部樣式表，然后才能將內容渲染到用戶屏幕。每個外部樣式表都必須從網絡下載。這些額外的網絡任務會顯著增加用戶在屏幕上看到任何內容之前必須等待的時間。

未使用的 CSS 還會減慢瀏覽器構建渲染樹的速度。渲染樹類似于 DOM 樹，不同之處在于它還包含每個節點的樣式。要構建渲染樹，瀏覽器必須遍歷整個 DOM 樹，并檢查哪些 CSS 規則適用于每個節點。未使用的 CSS 越多，瀏覽器可能需要花費更多的時間來計算每個節點的樣式。

PurgeCSS 是什么？

PurgeCSS 是一個用于刪除未使用的 CSS 的工具。它對于優化應用通常很有用。當使用 Bulma、Bootstrap 或 Tailwind 等 CSS 框架時，就會有很多未使用的 CSS。這就是 PurgeCSS 的用武之地。它會分析內容和 CSS 文件，以確定哪些樣式未使用，并將其刪除。PurgeCSS 可以與最常見的 JavaScript 庫/框架配合使用，例如 Vue.js、React、Gatsby 等。

雖然 PurgeCSS 并不是刪除未使用的 CSS 的唯一工具，但它因其模塊化、易用性和廣泛的自定義選項而脫穎而出。模塊化使開發人員能夠為特定用例和框架創建模塊提取器。提取器是讀取文件內容并提取所使用的 CSS 選擇器列表的函數。

PurgeCSS 提供了一個非?？煽康哪J提取器，可以處理多種文件類型。但是，默認情況下，PurgeCSS 會忽略包含 @、:和 / 等特殊字符的未使用 CSS 代碼。因此，PurgeCSS 可能無法完全適配你正在使用的文件類型或 CSS 框架。

此外，PurgeCSS 還有很多配置項，可以根據需求自定義其行為。例如，PurgeCSS 包括針對 fontFace、keyframes、extractors、CSS 等選項。定制化可以改善 PurgeCSS 的性能和效率。PurgeCSS 很容易上手，并提供了詳細的文檔。截至撰寫本文時，PurgeCSS 在 npm 上每周下載量超過 90 萬次，GitHub[1] 上獲得了 7.4k+ Star。

PurgeCSS 是如何工作的？

PurgeCSS 適合在生產環境使用，可以分析內容和 CSS 并刪除未使用的樣式。在開發過程中運行 PurgeCSS 是沒必要的，因為在開發過程中，可能會經常創建未使用的樣式，這意味著每次都必須運行 PurgeCSS。

相反，可以僅針對生產構建運行它。這樣，就不必重新創建已刪除的樣式。因此，當應用準備好投入生產時，可以運行 PurgeCSS 一次。在開始將 PurgeCSS 與流行的庫/框架一起使用之前，先來看一下它如何與普通 JavaScript 一起使用。代碼如下：

(async () => {
  const purgecss = await new PurgeCSS().purge({
    content: ['index.html'],
    css: ['style.css'],
  });

  console.log(purgecss);
})();

這里將 index.html 指定為內容之一，將style.css指定為 CSS 之一，可以包含更多的內容和 CSS 文件，并且內容不限于 HTML 文件。上面的代碼會返回已清除樣式的數組。

除了 content 和 css 之外，還有更多配置項可以準確指定想要它做什么以及如何做。上面的例子可以用于任何普通 JavaScript 項目。要使用 PurgeCSS，就需要有一個單獨的 JavaScript 文件，其將運行一次以刪除未使用的樣式。

可以通過以下代碼讓清除的樣式替換當前樣式：

const { PurgeCSS } = require('purgecss');
const fs = require('fs');

(async () => {
  const purgecss = await new PurgeCSS().purge({
    content: ['index.html'],
    css: ['style.css'],
  });

  fs.writeFileSync('style.css', purgecss[0].css);
})();

與JS庫/框架結合使用

PurgeCSS 與流行的 JavaScript 庫/框架是兼容的，如 React、Vue、Gatsby、Next.js、Nuxt.js 等。下面來看看如何將 PurgeCSS 與 React 和 Vue 一起使用。

React + PurgeCSS

首先需要安裝 PurgeCSS 及其依賴項：

npm i --save-dev @fullhuman/postcss-purgecss

打開 App.js 文件并粘貼以下代碼：

import "./App.css";

function App() {
  return <div className="App"></div>;
}

export default App;

在上面的代碼中，我們創建了一個名為 App 的函數組件，并返回了一個類名為 App 的 div。App.css 保持不變，因此它包含以下未使用的 CSS 代碼：

.App {
  text-align: center;
}

.App-logo {
  height: 40vmin;
  pointer-events: none;
}

@media (prefers-reduced-motion: no-preference) {
  .App-logo {
    animation: App-logo-spin infinite 20s linear;
  }
}

.App-header {
  background-color: #282c34;
  min-height: 100vh;
  display: flex;
  flex-direction: column;
  align-items: center;
  justify-content: center;
  font-size: calc(10px + 2vmin);
  color: white;
}

.App-link {
  color: #61dafb;
}

@keyframes App-logo-spin {
  from {
    transform: rotate(0deg);
  }
  to {
    transform: rotate(360deg);
  }
}

打開 package.json 文件并在 script 下添加以下代碼：

"postbuild": "purgecss --css build/static/css/*.css --content build/index.html build/static/js/*.js --output build/static/css"

post 是一個前綴，可以添加到任何 npm 腳本中，并在運行主腳本時自動運行。在這個例子中，postbuild 在執行構建腳本后運行。postbuild 執行的命令包含三個選項。

• --css 選項：指定 PurgeCSS 應處理的 CSS 文件，它可以是文件名數組或全局變量。
• --content 選項：指定 PurgeCSS 應分析哪些內容。
• --output 選項：指定應將純化的 CSS 文件寫入哪個目錄。默認情況下，它將結果放置在控制臺中。

本質上，postbuild 執行的命令執行以下操作：

1. 檢查 build/static/css 中的每個 CSS 文件。
2. 匹配文件中使用的選擇器并刪除任何未使用的 CSS。
3. 在 build/static/css 中輸出新的 CSS 文件。

現在，只需要運行 npm run build 來運行 React 應用的構建。要確認是否成功，可以打開 build/static/css 中的 CSS 文件。輸出類似于下面的代碼，僅包含使用的 CSS：

body {
  -webkit-font-smoothing: antialiased;
  -moz-osx-font-smoothing: grayscale;
  font-family: -apple-system, BlinkMacSystemFont, Segoe UI, Roboto, Oxygen,
    Ubuntu, Cantarell, Fira Sans, Droid Sans, Helvetica Neue, sans-serif;
  margin: 0;
}
code {
  font-family: source-code-pro, Menlo, Monaco, Consolas, Courier New, monospace;
}
.App {
  text-align: center;
}
@-webkit-keyframes App-logo-spin {
  0% {
    -webkit-transform: rotate(0deg);
    transform: rotate(0deg);
  }
  to {
    -webkit-transform: rotate(1turn);
    transform: rotate(1turn);
  }
}
@keyframes App-logo-spin {
  0% {
    -webkit-transform: rotate(0deg);
    transform: rotate(0deg);
  }
  to {
    -webkit-transform: rotate(1turn);
    transform: rotate(1turn);
  }
}

Vue + PurgeCSS

可以通過以下方式在 Vue 中安裝 PurgeCSS：

vue add @fullhuman/purgecss

這將生成一個 postcss.config.js 文件，在這個文件中已經設置了適合 Vue 應用的PurgeCSS 配置?？梢愿鶕枰倪@些配置。

下面來更新一些應用的內容，看看 PurgeCSS 在 Vue 中的工作原理。轉到 HelloWorld.vue 并用以下代碼替換其中的代碼：

<template>
  <a href="#">Hello world</a>
</template>
<script>
export default {
  name: 'HelloWorld',
  props: {
    msg: String,
  },
};
</script>

<style scoped>
h3 {
  margin: 40px 0 0;
}
ul {
  list-style-type: none;
  padding: 0;
}
li {
  display: inline-block;
  margin: 0 10px;
}
a {
  color: #42b983;
}
span {
  color: red;
}
</style>

這里減少了內容并添加了一些未使用的樣式?，F在，在終端中運行 npm run build 來構建應用并查看最終構建的 CSS。最后，在 dist/css 目錄中打開 CSS 文件，就可以找到只包含已使用樣式的 CSS 輸出：

a[data-v-70cf4e96] {
  color: #42b983;
}

#app {
  font-family: Avenir, Helvetica, Arial, sans-serif;
  -webkit-font-smoothing: antialiased;
  -moz-osx-font-smoothing: grayscale;
  text-align: center;
  color: #2c3e50;
  margin-top: 60px;
}

高級配置選項

上面只看到了三個配置選項：content、css 和 outline，下面來看看如何通過其他配置選項來自定義 PurgeCSS。

keyframes 和 fontfaces

在 PurgeCSS v2.0 之前，默認刪除未使用的字體和關鍵幀代碼。然而，當這些功能使用不當時，代碼就會崩潰。未使用的字體和關鍵幀代碼現在默認保持不變。可以通過將 keyframes 和 fontfaces 選項設置為 true 來更改此默認行為：

(async () => {
  const purgecss = await new PurgeCSS().purge({
    content: ['index.html'],
    css: ['style.css'],
    keyframes: true,
    fontFaces: true,
  });

  console.log(purgecss);
})();

也可以在 purgecss.config.js 配置文件中修改這些配置項：

// purgecss.config.js
module.exports = {
  content: ['index.html'],
  css: ['style.css'],
  keyframes: true,
  fontFaces: true,
}


(async () => {
  const purgecss = await new PurgeCSS().purge('./purgecss.config.js');
  console.log(purgecss);
})();

content 和 css

可以直接傳入 content 和 css 的值，而無需鏈接一個文件：

// purgecss.config.js
module.exports = {
  content: [
    {
      raw: '<html><body><p>Hello world</p></body></html>',
      extension: 'html',
    },
  ],
  css: [
    {
      raw: 'p { color: red }',
    },
  ],
};

extractors

在極少數情況下，PurgeCSS 可能無法刪除未使用的 CSS 或刪除已使用的 CSS。在這種情況下，必須使用自定義提取器。PurgeCSS 依賴提取器來獲取文件中使用的選擇器列表。

有些軟件包為特定擴展提供了提取器。例如，purgecss-from-js 特定于 .js 擴展名。使用特定的提取器進行擴展可以提供最佳的準確性：

// purgecss.config.js
import purgeJs from 'purgecss-from-js'
import purgeHtml from 'purgecss-from-html'

const options = {
  content: ['index.html'],
  css: ['style.css'],
  extractors: [
    {
      extractor: purgeJs,
      extensions: ['js']
    },
    {
      extractor: purgeHtml,
      extensions: ['html']
    }
  ]
}
export default options

variables

默認情況下，不會刪除未使用的 CSS 變量。如果要刪除它們，則必須在 purgecss.config.js 文件中將變量指定為 true：

module.exports = {
    content: ['index.html'],
    css: ['style.css'],
    variables: true,
}

safelist 和 comments

PurgeCSS 支持指定哪些選擇器可以安全地保留在最終的 CSS 中?？梢酝ㄟ^兩種方式來完成此操作：PurgeCSS 的 safelist 選項或特殊的 CSS 特殊注釋。使用 safelist：

module.exports = {
    content: ['index.html'],
    css: ['style.css'],
    safelist: ['random', 'button'],
}

在這種情況下，.random、#random、button、.button 和 #button 都將被忽略，不會被 PurgeCSS 刪除。其支持使用正則表達式：

module.exports = {
    content: ['index.html'],
    css: ['style.css'],
    safelist: [/red$/, /^bg/],
}

在這種情況下，任何以 red 結尾（例如，bg-red、btn-red）或以 bg 開頭（例如，bg-blue、bg-red）的選擇器都不會被刪除。默認情況下，PurgeCSS 不會刪除注釋，僅刪除旨在自定義 PurgeCSS 行為的特殊注釋。

一組常見的特殊注釋用于指定哪些選擇器可以安全地保留在最終 CSS 中：

/* purgecss start ignore */
h1 {
  color: pink;
  font-size: 2rem;
}
/* purgecss end ignore */

相關鏈接

[1]GitHub: https://github.com/FullHuman/purgecss。