統一的 CSS 編寫規範是團隊協作效率、程式碼可維護性、專案長期健康的基石。本文整理業界公認的核心原則:避免過度限定選擇器、善用縮寫屬性、消除重複、標準化格式化,並提供具體反面教材與正確範例對照。
/* ❌ 糟糕:過度限定 */
ul#nav { } /* ID 已唯一,ul 多餘 */
.menu#sidebar { } /* ID 已唯一,.menu 多餘 */
div.container { } /* class 已足夠,div 多餘 */
button.btn-primary { } /* 標籤限定降低複用性 */
/* ✅ 優秀:精準適度 */
#nav { }
#sidebar { }
.container { }
.btn-primary { }
危害:提高特定度(難覆蓋)、綁定 HTML 結構(換標籤樣式失效)、降低 class 複用性(.btn-primary 只能用在 button 上)。
/* ❌ 爛透了:極深後代選擇器 */
html body div header nav ul li a { color: #333; }
/* 問題:效能低、極度脆弱、HTML/CSS 強耦合、結構微調即失效 */
/* ✅ 優秀:單一語意化 class */
.nav-link { color: #333; }
/* ❌ 糟糕:冗長分散 */
.some-class {
padding-top: 20px;
padding-right: 10px;
padding-bottom: 20px;
padding-left: 10px;
background-color: #000;
background-image: url('../imgs/carrot.png');
background-position: bottom center;
background-repeat: repeat-x;
}
/* ✅ 優秀:縮寫合併,順時針順序 */
.some-class {
padding: 20px 10px; /* 上下 20px、左右 10px */
background: #000 url('../imgs/carrot.png') repeat-x bottom center;
}
/* 進階:多重背景、多重陰影分行對齊 */
.advanced {
background-image:
linear-gradient(45deg, #000, #ccc),
linear-gradient(#ccc, #ddd);
box-shadow:
2px 2px 4px #000,
1px 4px 6px #ddd inset;
}
/* ❌ 糟糕:重複宣告 */
.btn-primary { color: #fff; background: #0066cc; font-size: 1rem; }
.btn-secondary { color: #fff; background: #6c757d; font-size: 1rem; }
/* ✅ 優秀:提取共同基礎 */
.btn {
color: #fff;
font-size: 1rem;
padding: 0.5rem 1rem;
border-radius: 0.375rem;
}
.btn-primary { background: #0066cc; }
.btn-secondary { background: #6c757d; }
/* 或使用群組選擇器(僅限極簡單共同屬性) */
.btn-primary, .btn-secondary { color: #fff; font-size: 1rem; }
可讀性 = 可維護性。建議採用統一格式化規則(配合 Stylelint/Prettier 強制):
/* ✅ 選擇器分行:易讀、易版控差異比較 */
.selector-one,
.selector-two,
.selector-three {
property: value;
}
/* ✅ 多值屬性分行對齊 */
.complex {
background-image:
linear-gradient(#000, #ccc),
linear-gradient(#ccc, #ddd);
box-shadow:
2px 2px 4px rgba(0,0,0,0.1),
inset 1px 1px 0 rgba(255,255,255,0.5);
}
/* ✅ 屬性聲明順序建議(濃縮版) */
.ordered {
/* 1. 佈局/定位 */
position: relative;
display: flex;
z-index: 10;
/* 2. 盒模型 */
width: 100%;
padding: 1rem;
margin: 0 auto;
/* 3. 視覺樣式 */
background: #fff;
border: 1px solid #ddd;
border-radius: 0.5rem;
/* 4. 字體/文字 */
font: 1rem/1.5 sans-serif;
color: #333;
text-align: center;
/* 5. 修飾/動畫/其他 */
opacity: 1;
transition: all 0.2s;
}
/* ✅ 零值不需單位 */
margin: 0;
padding: 10px 0 20px 0;
border: 0;
outline: 0;
box-shadow: 0 0 0 0;
/* ❌ 多餘單位 */
margin: 0px;
padding: 10px 0px 20px 0px; /* 雖合法但冗餘 */
/* 十六進位小寫、可縮寫則縮寫 */
color: #fff; /* 不要 #FFFFFF */
color: #369; /* 不要 #336699 */
background: #f0f0f0;
/* rgba/hsl 用於需要透明度時 */
color: rgba(0, 0, 0, 0.6);
background: hsla(200, 50%, 50%, 0.8);
/* CSS 變數引用 */
color: var(--color-text-primary);
/* ✅ 推薦:嵌套在元件內部(支援 PostCSS nesting 或原生 CSS Nesting) */
.card {
padding: 1.5rem;
@media (max-width: 768px) {
padding: 1rem;
}
@media (min-width: 1200px) {
padding: 2rem;
}
}
/* ❌ 避免:集中在檔案底部的大量媒體查詢,難以維護關聯 */
@media (max-width: 768px) {
.card { padding: 1rem; }
.btn { font-size: 0.875rem; }
/* ...數百行後難以對應元件 */
}
# .stylelintrc.json 核心規則範例
{
"rules": {
"selector-max-id": 0, // 禁止 ID 選擇器做樣式
"selector-max-compound-selectors": 3, // 限制複合選擇器深度
"selector-class-pattern": "^[a-z][a-z0-9]*(-[a-z0-9]+)*(__[a-z0-9]+(-[a-z0-9]+)*)?(--[a-z0-9]+(-[a-z0-9]+)*)?$", // BEM 命名強制
"property-no-unknown": true, // 禁止未知屬性
"color-hex-case": "lower", // 十六進位小寫
"color-hex-length": "short", // 強制縮寫
"value-zero-unit": "never", // 零值禁單位
"declaration-block-semicolon-newline-after": "always", // 分號換行
"rule-empty-line-before": "always-multi-line", // 規則間空行
"at-rule-empty-line-before": "always",
"custom-property-pattern": "^[a-z][a-z0-9]*(-[a-z0-9]+)*$" // CSS 變數命名
}
}
CSS 編寫規範的核心精神是「為了讀者而寫,不只是為了瀏覽器」。遵循淺層選擇器、縮寫合併、消除重複、統一格式、語意化命名、零值無單位、媒體查詢內嵌八大原則,配合自動化 Lint 工具強制執行,能讓團隊產出一致、可預測、易於重構的高品質樣式代碼。規範不是束縛,而是釋放創造力的基礎設施。