命名規則看似瑣碎,卻直接影響代碼的可讀性。程式設計裡流傳最廣的三種命名法各有來歷與適用場景,分清楚它們,讀別人的代碼時會輕鬆許多。
顧名思義,是混合使用大小寫字母來構成名稱,讓每個邏輯斷點由一個大寫字母標記。比較一下同一個函數的兩種寫法:
printEmployeePaychecks(); /* 駱駝式 */ print_employee_paychecks(); /* 下劃線法 */
駱駝式近年越來越流行,在許多新的函式庫以及 Microsoft Windows 這類環境中相當常見。下劃線法則是 C 語言流行之後帶起的風氣,在許多舊程式與 UNIX 環境中使用普遍。
廣泛應用於 Microsoft Windows 這類環境。這套規則由微軟程式設計師 Charles Simonyi 提出,做法是在變量名前加上一或多個小寫字母作為前綴,用來標示變量的作用域與型別。多個標識可以同時使用,順序大致是:先 m_(成員變量),再指針標記,再簡單資料型別,最後其他。
例如 m_lpszStr 表示「指向一個以 0 結尾的字串的長指標成員變量」——把 m_、l、p、sz 逐段拆開讀,資訊就都出來了。
關鍵規則有兩點:標識符以一个或多個小寫字母開頭作為前綴;前綴之後是由首字母大寫的單詞組成的名稱,用來說明變量的用途。
與駱駝命名法幾乎相同,唯一的差別是首字母大寫:
DisplayInfo(); string UserName;
在 C# 中,帕斯卡命名法與駱駝命名法是最主流的兩種,通常約定為:類別、方法、屬性用帕斯卡,區域變數與參數用駱駝。
| 寫法 | 名稱 | 特徵 |
|---|---|---|
| MyData | 帕斯卡命名法 | 每個單詞首字母皆大寫 |
| myData | 駱駝命名法 | 首單詞首字母小寫,其後單詞首字母大寫,形似駱駝駝峰 |
| iMyData | 匈牙利命名法 | 小寫 i 標示型別,其後部分與帕斯卡相同 |
匈牙利命名法在今日多數語言中已不建議使用:現代 IDE 能即時顯示型別資訊,前綴反而成了噪音,型別一改名稱就全部失效。微軟自己的.NET 設計準則也明確反對。真正值得保留的是它的精神——名稱應該承載資訊;而承載型別不如承載含義,例如用 retryCount 取代 iCount,用 hasPendingItems 取代 bFlag。至於駱駝與帕斯卡,選一種並在團隊內保持一致,比選哪一種更重要。