萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網頁製作 >> Div CSS 教學

CSS 命名規範最佳實踐:避開常見陷阱,寫出可維護的樣式代碼

為什麼 CSS 命名習慣如此重要?

混亂、無語義的類名(如 .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,效率極高。

進階建議:採用 BEM 或 ITCSS 等方法論

  • BEM (Block Element Modifier):.card__title--highlighted,結構清晰、關係明確。
  • ITCSS (Inverted Triangle CSS):按層級組織樣式(Settings → Tools → Generic → Elements → Objects → Components → Utilities),配合命名空間(o-, c-, u-)管理優先級。

團隊專案中統一規範、配合 Stylelint 自動檢查,能從源頭杜絕命名混亂。

總結

  1. 語義化優先:命名描述「是什麼」,而非「長什麼樣」。
  2. 工具類例外:佈局/對齊等高頻原子類可用表象命名。
  3. 統一規範:全專案遵循同一命名約定(小寫連字符、BEM 等)。
  4. 善用工具:Stylelint + Prettier 強制格式化,代碼審查時重點檢查命名。

好名字是給未來的自己、給隊友寫的最好的文檔。從今天開始,給每個 class 一個會說話的名字吧!

copyright © 萬盛學電腦網 all rights reserved