分別從 Code Complete2 , Clean Code , The art of readable code 中擷取命名,變數的部份重點。
 
The art of readable code
1.更具體的描述(考慮名詞使用什麼,動詞使用如何來修飾)。
2.更合適的同義詞。
3.更多的意義(加入單位以及特殊意義)。
4.移除不需要的部份。
5.使用 Min and Max 代表極值。
6.使用 First and Last 代表包含值。
7.使用 Begin and End 代表包頭去尾。
8.boolean 可以使用 is , has , should , can 來修飾。
9.依照情況選擇 getXXX() , countXXX() , computeXXX()。


 
 
Code Complete2
1.盡量保持8~20字元長度。
2.問題導向,表示什麼(what)而不是如何。
3.關於計算的限定詞放到句尾,e.g. Sum , Total , Average , Max , Min。
4.小心魔術數字,可排除0和1。
5.小心除零錯誤(分母為零)
6.小心不同類型的轉換
7.小心編譯器的警告
8.狀態變數的命名,不要使用state , flag 等等看不出意義的字詞。
9.暫時變數的命名,不要使用temp , 除非真的作為temp使用。
10.布林變數的命名,常見的為 done , found , success , ok , error , 考慮使用更具體的名稱來取代以上命名。
11.列舉的命名格式,e.g.

public enum ErrorType{
DISCONNECT_ERROR , CONNECT_ERROR}

12.常數的命名,盡量不要加入具體數字。


 
Clean Code
1.名副其實(具體的描述變數與變數單位)
2.避免誤導(不要使用縮寫,不要加入型態)
3.有意義的區別(不要同時使用難以區別的名稱,不要加入不必要的字詞)
4.優先使用電腦領域術語
5.介面與實作
6.類別與方法
7.每種概念使用同一種字詞。