CSS 命名雖不影響瀏覽器渲染,卻決定了代碼的可讀性、可維護性與團隊協作效率。糟糕的命名(如 .red、.leftBar、.aaabb)會導致樣式與結構強耦合,一旦設計變更(如紅字改藍、左欄移右),類別名稱即失去語意,甚至產生誤導。
| ❌ 反面教材 | ✅ 建議命名 | 理由 |
|---|---|---|
.red | .error-msg / .highlight | 描述用途而非顏色 |
.leftBar | .sidebar / .aside-nav | 描述組件角色而非位置 |
.big-title | .page-heading / .hero-title | 語意化、不隨設計調整而失效 |
.block__element--modifier(如 .card__title--large),結構清晰、作用域明確。.btn-primary、.form-input、.nav-link,一眼即知用途。.text-center、.d-flex、.m-0,單一職責、可複用,命名可帶前綴(如 u-、util-)區分。若某樣式極少變動(如清除浮動 .clearfix、文字對齊 .text-right),直接用外觀命名反而更直觀,但建議集中管理於 utilities.css。
建立團隊命名規範文件,配合 Code Review 強制執行,長遠來看能節省無數重構工時。