代码整洁之道-07
代碼中隨處可見命名,包括變量、函數(shù)、參數(shù)、類和包以及源碼所在目錄的命名等。好的命名因遵循以下幾條規(guī)則。
1、名副其實(shí)
選擇體現(xiàn)本意的、易理解的名稱。
2、避免誤導(dǎo)
避免使用縮寫,避免使用小寫字母l和大寫字母O作為變量。
3、做有意義的區(qū)分
NameString命名會(huì)比Name好嗎?
4、使用讀的出來的名稱
命名一個(gè)生成日期、年、月、日、時(shí)、分、秒的變量。genymdhms這個(gè)好嗎?肯定是不好的。
5、使用可搜索的名稱
單個(gè)數(shù)字或字母很難在全篇代碼中找到。
6、避免使用編碼
編碼已經(jīng)很全,無需自己搞一套。
7、去掉成員變量前綴
不必用m_前綴來標(biāo)明成員變量,應(yīng)當(dāng)把類和函數(shù)做的足夠小,消除對(duì)成員前綴的需要,可以使用編輯器的高亮或顏色功能標(biāo)出。
8、避免思維映射
避免將名稱讓讀者在腦海中翻譯成他們熟知的名稱。
9、每個(gè)概念對(duì)應(yīng)一個(gè)詞
同一堆代碼中有controller又有manager,為什么不全用manager或controller。
10、別用雙關(guān)語
避免將同意單詞用于不同目的。
11、使用解決方案領(lǐng)域名稱
只有程序員才會(huì)讀代碼,所有盡量用計(jì)算機(jī)科學(xué)術(shù)語、算法名等。
12、使用源自所涉問題領(lǐng)域的名稱
如果不能用程序員熟悉的術(shù)語來命名,就采用所涉及問題領(lǐng)域的術(shù)語來命名。
13、添加有意義的語境
很少有名稱能自我說明,我們需要有良好的命名類、函數(shù)或名稱空間來放置名稱,給讀者提供語境。
總結(jié)
- 上一篇: 代码整洁之道-06
- 下一篇: 什么是schema?