混亂、無語義的類名(如 .aaabb)會讓任何接手代碼的開發者抓狂。良好的命名不僅關乎代碼美觀,更直接影響專案的可維護性與團隊協作效率。本文將從反面教材出發,深入淺出地講解 CSS 命名的核心原則與實戰技巧。
許多初學者會根據元素的視覺特徵命名,例如:
.red { color: red; } — 當需求改為藍色時,類名卻仍叫 red,極易誤導。.leftBar { ... } — 若側邊欄移至右側,類名即失去意義。這類命名將「樣式表現」與「結構語義」強綁定,一旦設計變更,HTML 與 CSS 就會出現語義不符的尷尬局面。
應根據模組在頁面中的角色命名,例如:
#navigation / .nav — 導航區塊.sidebar — 側邊欄(不限左右).post-wrap / .article-content — 文章容器.btn-primary / .btn-secondary — 主要/次要按鈕這樣無論樣式如何調整(顏色、位置、字號),類名依然精準描述模組用途,HTML 結構與樣式解耦。
對於「極少變動、高度通用」的工具類,可適度使用表象命名,因為其語義本身就是樣式行為:
.align-left { float: left; margin-right: 1rem; }
.align-right { float: right; margin-left: 1rem; }
.clearfix { clear: both; }
.visually-hidden { position: absolute; width: 1px; height: 1px; overflow: hidden; }
使用時直接在 HTML 切換類名即可:<p class="align-left">...</p> → <p class="align-right">...</p>,無需動 CSS,效率極高。
.card__title--highlighted,結構清晰、關係明確。o-, c-, u-)管理優先級。團隊專案中統一規範、配合 Stylelint 自動檢查,能從源頭杜絕命名混亂。
好名字是給未來的自己、給隊友寫的最好的文檔。從今天開始,給每個 class 一個會說話的名字吧!