緊急上線 → 內嵌 <style> / 內聯 style="" → 積累成山 → 重構噩夢。這是無數專案的共同軌跡。
<!-- ✅ 標準引入 -->
<link rel="stylesheet" href="/css/main.css">
<!-- ✅ 模組化導入 -->
@import url("/css/components/button.css");
@import url("/css/layout/header.css");
<!-- ❌ 禁止:內嵌樣式表 -->
<style> .ad-hoc { color: red; } </style>
<!-- ❌ 禁止:內聯樣式 -->
<div style="color: red; margin: 10px;">
例外:關鍵 CSS 內聯(Critical CSS)用於首屏渲染優化,由構建工具自動提取注入。
css/
├── base/
│ ├── reset.css # Normalize/Reset
│ ├── variables.css # CSS Custom Properties
│ └── typography.css # 字體基礎
├── layout/
│ ├── grid.css # 佈局網格
│ ├── header.css
│ ├── footer.css
│ └── sidebar.css
├── components/
│ ├── button.css
│ ├── card.css
│ ├── modal.css
│ └── form.css
├── utilities/
│ ├── spacing.css
│ ├── visibility.css
│ └── text.css
├── themes/
│ ├── light.css
│ └── dark.css
├── pages/
│ ├── home.css
│ └── article.css
├── vendors/
│ └── normalize.css
├── main.css # 入口:按依序 @import 以上檔案
└── critical.css # 首屏關鍵 CSS(構建生成)
| 指標 | 工具 | 閾值建議 |
|---|---|---|
| 重複代碼率 | stylelint + stylelint-no-duplicate-selectors | < 5% |
| 未使用 CSS | PurgeCSS / UnCSS | 0 |
| 選擇器嵌套深度 | stylelint selector-max-compound-selectors | ≤ 3 |
| !important 數量 | grep / stylelint | ≤ 5/萬行(僅工具類/第三方覆蓋) |
| 文件大小 | gzip 後 | < 50 KB (含關鍵 CSS) |
| HTTP 請求數 | Network 面板 | 生產環境合併為 1-2 條 |
/* variables.css */
:root {
--color-primary: #0066cc;
--color-bg: #ffffff;
--color-text: #333333;
}
[data-theme="dark"] {
--color-primary: #4da6ff;
--color-bg: #1a1a1a;
--color-text: #e0e0e0;
}
/* 組件使用變數,零代碼變更實現換膚 */
.btn-primary { background: var(--color-primary); color: var(--color-bg); }
.page { background: var(--color-bg); color: var(--color-text); }
CSS 整潔不是潔癖,是工程效能的生命線。外聯模組化、變數驅動主題、自動化治理、CI 守門,四位一體構建可持續演進的樣式架構。拒絕「快速修補」誘惑,每一行 CSS 都應有其歸屬的模組與清晰的語義——這是專業前端工程師的底線。