惯性聚合 高效追踪和阅读你感兴趣的博客、新闻、科技资讯
阅读原文 在惯性聚合中打开

推荐订阅源

L
LangChain Blog
B
Blog RSS Feed
阮一峰的网络日志
阮一峰的网络日志
Cyber Security Advisories - MS-ISAC
Cyber Security Advisories - MS-ISAC
H
Help Net Security
MyScale Blog
MyScale Blog
WordPress大学
WordPress大学
Microsoft Azure Blog
Microsoft Azure Blog
GbyAI
GbyAI
小众软件
小众软件
大猫的无限游戏
大猫的无限游戏
Martin Fowler
Martin Fowler
Vercel News
Vercel News
S
SegmentFault 最新的问题
M
MIT News - Artificial intelligence
Microsoft Security Blog
Microsoft Security Blog
G
Google Developers Blog
Last Week in AI
Last Week in AI
Hugging Face - Blog
Hugging Face - Blog
酷 壳 – CoolShell
酷 壳 – CoolShell
博客园 - 【当耐特】
Google DeepMind News
Google DeepMind News
Engineering at Meta
Engineering at Meta
云风的 BLOG
云风的 BLOG

DEV Community

Authentication Security Deep Dive: From Brute Force to Salted Hashing (With Java Examples) Why AI Systems Don’t Fail — They Drift Spilling beans for how i learn for exam😁"Reinforcement Learning Cheat Sheet" I Replaced Chrome with Safari for AI Browser Automation. Here's What Broke (and What Finally Worked) How Python Borrows Other People's Work The $40 Architecture: Processing 1 Billion API Requests with 99.99% Uptime Vibe Coding: A Workflow Guide (From Zero to SaaS) Most webhook security guides protect the wrong side. The scary part is delivery. Headless CMS for TanStack Start: Build a Blog with Cosmic EU Age Verification App "Hacked in 2 Minutes" — What Actually Happened Comfy Cloud’s delete function does not actually remove files Running AI Models on GPU Cloud Servers: A Beginner Guide Event-driven media intelligence with AWS Step Functions and Bedrock I scored 500 AI prompts across 8 quality dimensions — here's what broke How to Call Google Gemini API from Next.js (Free Tier, No Backend Needed) The Portal Protocol: Reclaiming Human Connection in the Age of AI How to Fix Your Team's Scattered Knowledge Problem With a Self-Hosted Forum Intro to tc Cloud Functors: A Graph-First Mental Model for the Modern Cloud Designing Multi-Tenant Backends With Both Ownership and Team Access I Built a Neumorphic CSS Library with 77+ Components — Here's What I Learned PostgreSQL Performance Optimization: Why Connection Pooling Is Critical at Scale Cómo construí un SaaS multi-rubro para gestionar expensas en Argentina con FastAPI + Vue 3 🚀 I Built an Ethical Hacking Scanner Tool – Open Source Project I Replaced /usage and /context in Claude Code With a Single Statusline A Pythonic Way to Handle Emails (IMAP/SMTP) with Auto-Discovery and AI-Ready Design I Collected 8.9 Million Polymarket Price Points — Here's What I Found About How Markets Really Move EcoTrack AI — Carbon Footprint Tracker & Dashboard Everyone's Using AI. No One Agrees How. 5 self-hosted ebook managers worth trying in 2026 Building Your First AI Agent with LangChain: From Chatbot to Autonomous Assistant
How to Audit Your CSS for Unused Rules and Reduce Load Ti...
Kui Luo · 2026-06-12 · via DEV Community

Kui Luo

Every CSS file ships rules that never match a single element on the page. In my recent audit of a mid-size web app with 14 production pages, I found 2,847 unused selectors across 3 combined stylesheets totaling 340 KB. Removing them cut the CSS payload from 340 KB to 132 KB — a 61% reduction in file size and a 1.8-second improvement in Largest Contentful Paint (LCP) on a simulated 4G connection.

Here's the step-by-step method I used, along with the exact tool settings that produce reliable results.

The Problem: Why Unused CSS Accumulates

Unused CSS comes from five sources:

  1. Framework defaults — Reset stylesheets and utility frameworks ship 4,000+ rules; most pages use fewer than 400
  2. Dead features — Buttons, modals, and layouts removed from the UI but their styles remain in the bundle
  3. Responsive leftovers — Media queries for breakpoints that no longer match any viewport used by analytics
  4. Third-party overrides — Compensating selectors added to override library defaults
  5. Duplicate declarations — The same property set declared in multiple rule blocks targeting overlapping selectors
Source Average Unused Rules Typical Size Waste
Framework defaults 1,200–1,800 80–120 KB
Dead features 400–800 30–60 KB
Responsive leftovers 200–500 15–35 KB
Third-party overrides 100–300 8–25 KB
Duplicate declarations 50–150 3–12 KB

Step 1: Generate a Coverage Report in Chrome DevTools

Open DevTools (F12) → Ctrl+Shift+P → type "Coverage" → select "Start measuring coverage".

Click the reload button in the Coverage panel. Chrome instruments your CSS and reports which bytes of each stylesheet are executed versus unused.

Key metric to watch: The unused byte ratio. In my audit, the main stylesheet showed 73% unused bytes (248 KB out of 340 KB).

Record the percentage for each file. If any single file exceeds 60% unused bytes, it's a strong candidate for pruning.

Step 2: Extract Unused Selectors with Puppeteer

For automated audits, use Puppeteer's CSS.coverage protocol:

const puppeteer = require('puppeteer');

(async () => {
  const browser = await puppeteer.launch();
  const page = await browser.newPage();

  await page.goto('https://your-site.com');
  await page.coverage.startCSSCoverage();

  // Simulate real user interactions
  await page.evaluate(() => {
    document.querySelectorAll('button, a, [role="tab"]').forEach(el => {
      el.click();
    });
  });

  const coverage = await page.coverage.stopCSSCoverage();
  let totalUnused = 0;

  for (const entry of coverage) {
    const unused = entry.ranges
      .filter(r => !r.count)
      .reduce((sum, r) => sum + (r.end - r.start), 0);
    totalUnused += unused;
  }

  console.log(`Total unused CSS bytes: ${totalUnused}`);
  await browser.close();
})();

Run this script against every unique page template in your application. The total unused bytes across all pages gives you your pruning target.

Step 3: Cross-Reference with Real Usage Data

Coverage data alone is misleading because:

  • It only measures what a single page load uses
  • Dynamic states (hover, focus, open menus) may not trigger during the audit
  • JavaScript-toggled classes won't appear in coverage

To filter false positives, cross-reference your coverage results with your analytics:

  • Export the list of unused selectors from Step 2
  • Filter out any selector containing a class name that appears in your JavaScript source code
  • Filter out pseudo-class selectors (:hover, :focus, :active) — these never fire during coverage but are needed
  • Filter out @keyframes and animation-related selectors

After this filtering, my audit went from 3,400 "unused" selectors to 2,847 genuinely unused selectors.

Step 4: Purge with css-tree

For programmatic removal, parse the stylesheet and strip unmatched selectors:

const { parse, generate } = require('css-tree');

const css = require('fs').readFileSync('styles.css', 'utf8');
const usedClasses = new Set(['container', 'btn', 'nav-link', /* ... */]);

const ast = parse(css);
ast.children = ast.children.filter(node => {
  if (node.type === 'Rule') {
    const selector = generate(node.prelude);
    return [...selector.matchAll(/\.([a-zA-Z][\w-]*)/g)]
      .some(m => usedClasses.has(m[1]));
  }
  return true;
});

require('fs').writeFileSync('styles-clean.css', generate(ast));

This reduced the file from 340 KB to 132 KB in under 2 seconds of processing.

Step 5: Verify Nothing Broke

After purging, run these three checks:

  1. Visual regression — Screenshot every page before and after, diff with Pixelmatch (threshold: 0.1%)
  2. Interaction audit — Tab through every focusable element, toggle every dropdown and modal
  3. Performance validation — Re-run Lighthouse and confirm LCP improved by the expected margin

Results Summary

Metric Before After Change
CSS file size 340 KB 132 KB −61%
Selector count 6,234 3,387 −46%
LCP (4G) 4.2s 2.4s −1.8s
Lighthouse Performance 72 89 +17 points

The entire audit and cleanup took approximately 4 hours for a 14-page application — most of that spent on the cross-referencing step. For smaller sites with fewer dynamic states, expect 1–2 hours.

The method scales: set up the Puppeteer script as a CI job, run it weekly, and unused CSS stops accumulating.