專案迭代久了,CSS 檔案常殘留大量廢棄規則——舊功能下線、重構遺留、實驗性樣式等。這些「死碼」不僅增加載入體積,還干擾維護。瀏覽器原生 document.styleSheets API 讓我們能輕鬆掃描全站樣式應用情況。
document.styleSheets 獲取所有 CSS 規則selectorText 傳給 document.querySelectorAll().length,按覆蓋率排序const usage = [];
const sheets = document.styleSheets;
for (let i = sheets.length - 1; i >= 0; i--) {
const rules = sheets[i].cssRules || sheets[i].rules; // 兼容 IE
for (let j = rules.length - 1; j >= 0; j--) {
const selector = rules[j].selectorText;
if (!selector) continue; // 跳過 @media 等非選擇器規則
try {
const count = document.querySelectorAll(selector).length;
usage.push({ selector, count });
} catch (e) {
console.warn(`選擇器無效: ${selector}`, e);
}
}
}
usage.sort((a, b) => b.count - a.count); // 高覆蓋率優先
console.table(usage.map(u => ({
選擇器: u.selector,
匹配數: u.count,
狀態: u.count ? '✅ 活躍' : '⚠️ 疑似無用'
})));


以下場景會導致誤判:
:hover、:focus、:active 需交互觸發.show、.hidden、[data-state="loading"]@media 內規則在特定視口才生效Chrome DevTools Coverage 面板(Cmd+Shift+P → "Show Coverage")提供:
// Puppeteer 自動化掃描全站
const puppeteer = require('puppeteer');
async function auditCSSCoverage(urls) {
const browser = await puppeteer.launch();
const page = await browser.newPage();
await page.coverage.startCSSCoverage();
for (const url of urls) {
await page.goto(url, { waitUntil: 'networkidle2' });
// 觸發互動狀態
await page.hover('a, button, input');
await page.click('[tabindex]');
}
const coverage = await page.coverage.stopCSSCoverage();
await browser.close();
return coverage; // 含每個檔案的使用率、未用字節範圍
}
20 行原生 JS 即可構建基礎掃描器,適合快速排查;生產環境建議接入 Puppeteer + Coverage API 實現全自動化、全場景的 CSS 健康度監控。記住:工具只能發現疑點,人工驗證才能確認廢棄——保留那 1% 的「可能有用」總比誤刪 0.1% 的「關鍵樣式」安全。