CSS 命名規範不僅是代碼風格問題,更關乎團隊協作效率、代碼可維護性、設計系統一致性。業界主流存在三大命名法則——駝峰式、匈牙利、帕斯卡,各有歷史淵源與適用場景。本文深度對比三大法則核心邏輯、優劣勢、CSS 領域適用性,並給出現代前端工程推薦的統一命名策略與工具鏈落地方案。
| 維度 | 駝峰式 | 帕斯卡 | 匈牙利 |
|---|---|---|---|
| 首字母 | 小寫 | 大寫 | 小寫前綴 + 大寫主體 |
| 單詞分隔 | 大寫字母標記邏輯斷點 | 大寫字母標記邏輯斷點 | 前綴標記類型/作用域,主體帕斯卡式 |
| 典型示例 | printEmployeePaychecks() | DisplayInfo(), UserName | m_lpszStr (成員長指針字符串) |
| 起源領域 | Java、JavaScript、C# 變量/方法 | C# 類/接口/公共成員、Pascal 語言 | C/C++、Windows API、Microsoft 內部 |
| 核心哲學 | 可讀性優先,邏輯斷點可視化 | 類型/構造體標識,區分於變量 | 編碼即文檔:名字攜帶類型/作用域信息 |
| CSS 適用性 | ⚠️ 低:CSS 類名區分大小寫但不區分大小寫語義,易混淆 | ⚠️ 低:同駝峰,CSS 類名慣用 kebab-case | ❌ 不適用:前綴語義與 CSS 無關,極難閱讀 |
.myClass 與 .myclass 視為同一選擇器,駝峰/帕斯卡的大小寫語義在 CSS 中失效。font-size)、屬性值(inline-block)、偽類(:first-child)均用連字符。類名遵循 kebab-case 才能與生態一致。m_、lpsz 表達「成員長指針字符串」,在 CSS 中無任何語義映射,純粹增加認知負擔。/* ✅ 標準 */
.button-primary { }
.card__header { }
.nav-item--active { }
.is-loading { }
.has-error { }
/* ❌ 禁用 */
.buttonPrimary { } /* 駝峰 */
.ButtonPrimary { } /* 帕斯卡 */
.m_btnPrimary { } /* 匈牙利 */
.btn_prm { } /* 模糊縮寫 */
/* Block: 獨立組件 */
.card { }
/* Element: 組件內部部件,雙下劃線 */
.card__image { }
.card__title { }
.card__description { }
.card__action { }
/* Modifier: 組件/元素變體,雙連字符 */
.card--featured { }
.card--compact { }
.card__title--large { }
.card__action--primary { }
/* State: 狀態類,is-/has- 前綴(JS 切換) */
.card.is-selected { }
.card.has-error { }
.card.is-loading { }
/* 佈局 */
.flex { display: flex; }
.grid { display: grid; }
.container { width: 100%; max-width: 1200px; margin: 0 auto; }
/* 間距 (Tailwind 風格) */
.m-0 { margin: 0; }
.mt-4 { margin-top: 1rem; }
.px-6 { padding-left: 1.5rem; padding-right: 1.5rem; }
/* 顯示/隱藏 */
.hidden { display: none; }
.invisible { visibility: hidden; }
/* 文本 */
.text-center { text-align: center; }
.text-sm { font-size: 0.875rem; }
.font-bold { font-weight: 700; }
.truncate { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
/* 顏色 */
.bg-primary { background-color: var(--color-primary); }
.text-error { color: var(--color-error); }
.border-muted { border-color: var(--color-muted); }
| 語義域 | 標準詞彙 | 禁用/別名 |
|---|---|---|
| 容器 | container, wrapper, box, inner | outer, main-div, wrap |
| 導航 | nav, menu, tabs, breadcrumb, pagination | navbar, topbar, menubar |
| 按鈕 | btn, button, action, trigger, cta | btn-submit, click-me, link-btn |
| 表單 | form, field, input, label, select, checkbox, radio, textarea | txt, sel, chk, rad |
| 反饋 | alert, toast, modal, dialog, tooltip, popover, spinner, skeleton | msg, tip, popup, loader |
| 媒體 | img, image, video, audio, avatar, thumbnail, gallery, carousel | pic, photo, banner, slide |
| 狀態 | active, inactive, disabled, loading, error, success, warning, empty | on, off, ok, fail, hide |
| 尺寸 | sm, md, lg, xl, xs, xxl, fluid, full, auto, fit | big, small, large, tiny |
| 方位 | top, right, bottom, left, start, end, center, between, around | up, down, l, r, t, b |
// .stylelintrc.json
{
"rules": {
"selector-class-pattern": [
"^[a-z][a-z0-9]*(-[a-z0-9]+)*(__[a-z0-9]+(-[a-z0-9]+)*)?(--[a-z0-9]+(-[a-z0-9]+)*)?$",
{
"message": "類名必須符合 kebab-case BEM 規範:.block、.block__element、.block--modifier"
}
],
"selector-id-pattern": "^$", // 禁止 ID 選擇器
"custom-property-pattern": "^--[a-z]+-[a-z0-9]+(-[a-z0-9]+)*$", // CSS 變量命名
"selector-pseudo-class-no-unknown": [true, { "ignorePseudoClasses": ["global", "local"] }]
}
}
csscss 或 stylelint --custom-syntax 掃描現有類名分布@deprecated 註釋過渡駝峰、帕斯卡、匈牙利命名法在各自編程語言領域大放異彩,但CSS 選擇器不區分大小寫、標準分隔符為連字符、語義表達優於類型編碼的特性,決定了它們在 CSS 中均不適用。現代 CSS 工程化的標準答案是:kebab-case 基礎語法 + BEM 結構化組件命名 + 功能語義化工具類 + 團隊統一詞彙表 + Stylelint 強制執行。這不是風格偏好,是工程紀律。