命名是 CSS 維護性的核心。建立系統化命名規範:避免狀態耦合、統一詞彙表、採用模塊前綴、推行 BEM 結構化命名。
核心原則
- 語義而非表現:用
.error-msg 而非 .red-text;顏色變更時名稱仍有效
- 字符集限制:
- Class:小寫字母、數字、下劃線
_、連字符 -,字母開頭
- ID:同上,但不可數字開頭
- 結構化模式:
[模塊前綴|類型|動作]_[名稱]_[狀態|位置]
通用詞彙縮寫表(團隊統一)
| 全拼 | 縮寫 | 全拼 | 縮寫 |
| 設定 | set | 成功 | suc |
| 提示 | hint | 操作 | op |
| 密碼 | pw | 菜單 | menu / nav |
| 按鈕 | btn | 文本 | txt / tx |
| 顏色 | c / clr | 背景 | bg |
| 邊框 | bor / bd | 居中 | ctr / mid |
| 圖標 | ico / icon | 彈出 | pop / dlg |
| 輸入框 | input / ipt | 容器 | wrap / ct |
實戰命名示例
| 語義 | Class 命名 | 說明 |
| 文本輸入框 | .input_txt | 類型_名稱 |
| 密碼輸入框 | .input_pw | |
| 登錄密碼輸入框 | .input_pw_login | 模塊_類型_名稱 |
| 日志設置成功提示 | .hint_suc_blogset | 動作_狀態_模塊 |
| 相冊彈出設置層 | .pop_set_photo | 類型_動作_模塊 |
| 公共提示背景 | .hint_bg | |
| 文本顏色 | .c_txt | 屬性_對象 |
| 段落文本顏色 | .c_txt_p | 屬性_對象_限定 |
BEM 規範對比
/* 傳統 */ .search_input_login { }
/* BEM */ .search__input--login { }
.block__element--modifier
優勢:結構清晰、關係明確、工具友好(Stylelint、IDE 跳轉)
工程化落地
- Stylelint 配置
selector-class-pattern 強制命名規則
- IDE Snippets 內置常用模塊前綴
- 設計系統輸出 Design Tokens → CSS 變量 → 語義化 Class 自動生成
- Code Review 清單納入命名檢查項
避坑指南
- 禁用
.left、.big、.red 等表現類名
- 禁用過長名稱(>30 字符)或過短(<3 字符無語義)
- 同一模塊內類名保持前綴一致
- JS 掛鉤專用前綴
.js-,樣式類嚴禁供 JS 選取