三大主流命名風格
| 風格 | 範例 | 特點 | 流行生態 |
| 駝峰式 | myDataList getUserInfo | 首詞小寫,後續單詞首字母大寫 | JavaScript、Java、C#、現代 CSS-in-JS |
| 下劃線式 | my_data_list get_user_info | 單詞全小寫,下劃線分隔 | Python、Ruby、C、Linux 核心、BEM CSS |
| 帕斯卡式 | MyDataList UserInfo | 每個單詞首字母大寫 | C# 類別/介面、React 元件、CSS 模組化類名 |
匈牙利命名法(歷史產物)
m_lpszStr // m_ 成員變數 + lpsz 長指針以零結尾字串
dwCount // dw 雙字無符號整數
hwndMain // hwnd 視窗句柄
- 前綴編碼類型/作用域,後綴表達用途
- Windows API、MFC 大量使用
- 現代強型別語言不推薦:IDE 已提供型別提示,前綴反成噪音
CSS 實戰命名建議(BEM + 降駝峰)
/* 區塊 */
.card {}
/* 元素 */
.card__title {}
.card__image {}
/* 修飾符 */
.card--highlighted {}
.card__title--large {}
- 類名全小寫 + 下劃線(BEM 標準)
- JS 掛鉤用
js- 前綴:js-modal-trigger
- 工具類用
u-:u-text-center
- 狀態類用
is-:is-active、is-hidden
專案層級規範模板
/* config/naming-convention.md */
1. 類名:kebab-case(.btn-primary、.card__body)
2. ID:kebab-case(#main-header),僅作錨點/JS 掛鉤
3. CSS 變數:--color-primary、--spacing-md
4. Sass 變數:$color-primary、$spacing-md
5. Keyframes:@keyframes fade-in、slide-up
6. 禁止:縮寫不明(.c、.d)、中文拼音、隨機數字
自動化檢查
# stylelint 配置片段
"selector-class-pattern": "^([a-z][a-z0-9]*)(-[a-z0-9]+)*(__[a-z0-9]+(-[a-z0-9]+)*)?(--[a-z0-9]+(-[a-z0-9]+)*)?$"