postcss-loader。
什麼情況下適合使用 PostCSS
- 你需要在擴充功能樣式中加上 autoprefix 或現代 CSS 轉換。
- 你想在 popup、options、sidebar 與 content script 之間共用同一條 CSS 轉換 pipeline。
- 你正在使用 Tailwind 或以 plugin 為基礎的樣式處理。
PostCSS 能做到的事
範本範例
Tailwind + PostCSS 起手範本
當你想要一份可運作的 PostCSS + Tailwind 設定,且採用元件驅動的 UI 時,使用這個範本。
偵測機制與設定檔
Extension.js 會在專案根目錄依下列順序檢查 PostCSS 設定檔,並使用找到的第一個:.postcssrc.postcssrc.json.postcssrc.yaml.postcssrc.yml.postcssrc.ts/.postcssrc.cts/.postcssrc.mts.postcssrc.js/.postcssrc.cjs/.postcssrc.mjspostcss.config.ts/postcss.config.cts/postcss.config.mtspostcss.config.js/postcss.config.cjs/postcss.config.mjs.config/資料夾裡同樣的postcssrc名稱
postcss.config.*。在 package.json 設定了 "type": "module" 的專案裡,以純 .js 結尾的設定排在其他所有名稱之後嘗試。
它也會辨識 package.json 中的 postcss 設定。
在既有擴充功能中使用 PostCSS
安裝 PostCSS 相依套件:建立 postcss.config.js
使用方式
在擴充功能頁面中正常匯入樣式:css pipeline,content script 採用 asset pipeline)。
與 Tailwind 的互動
- 當 Extension.js 偵測到 Tailwind 時,會自動觸發 PostCSS 的設定流程。
- Extension.js 同時處理 Tailwind v3 與 v4,並依偵測到的版本選擇對應的 plugin。
- 在 ECMAScript Module(ESM)專案中,如果你的 PostCSS 設定使用了不相容的 CommonJS(CJS)寫法,Extension.js 可能會繞過你的設定,並改為注入相容性 plugin。
設定或 plugin 無法載入時
從 4.1.41 之後的版本起,Extension.js 無法使用的 PostCSS 設定會被擱置,建置在沒有它的情況下繼續:- 設定檔拋出錯誤,或匯入失敗。
- 設定匯出的函式拋出錯誤。
plugins既不是陣列,也不是以 plugin 名稱為鍵的物件。
postcss-loader。從 4.1.41 之後的版本起,Extension.js 會自己讀取 YAML rc 檔,它的 plugin 路徑從你的專案解析。
設定中列出但無法解析的 plugin 也會被跳過。警告為 Couldn't resolve the PostCSS plugin <name>.,該 plugin 本應產生的樣式不會出現在輸出中。
即使每條樣式規則都讀取同一份設定,這些警告在每次建置中也只印出一次。在 dev 期間,只有當問題消失後又出現時,警告才會再次印出。
從 4.2.0 之後的版本起,這些設定警告帶有代碼 W_CSS_NOT_APPLIED。這包括本節與下方清單中的警告,以及設定中某條規則替樣式表檔案設定了 Extension.js 不會套用的 type 時的警告。只有 dev 需要重新啟動的提示保留 W_RESTART_REQUIRED。4.2.0 及之前的版本給它們全部的是 W_RESTART_REQUIRED。
從 4.1.41 之後的版本起:
postcss.config.json、postcss.config.yaml與postcss.config.yml是 PostCSS 從不讀取的名稱。建置會發出警告,並指出要改成的 rc 檔名,例如.postcssrc.json。- Tailwind 只從你的專案取得。沒有它的 PostCSS plugin 時,會有一則警告指出安裝指令。
- 在
dev期間,PostCSS 或 Tailwind 設定的修改會在下一次建置時套用。 - 新增或移除 PostCSS 步驟的變更,會警告
dev需要重新啟動。 - 設定中的
parser、syntax、stringifier與map選項會與其外掛一起生效。以字串命名的模組從你的專案中解析。
最佳實務
- 讓 plugin 鏈保持精簡、明確(例如
autoprefixer、postcss-preset-env)。 - 確認設定檔格式(
.mjs或.cjs)與你的專案模組類型一致。 - 讓 Tailwind 與 PostCSS 的版本對齊,避免 plugin 解析不一致。
- 優先使用共用的樣式入口檔,讓擴充功能各個介面的處理結果可預期。
下一步
- 搭配 PostCSS 設定 Tailwind CSS。
- 透過 Stylelint 加入樣式表檢查。

