不要注釋秘密。如果你開發一個航班系統,請你一定要保證每有一個新的航班被加入,就得要修改25個以上的位置的程序。千萬別把這個事寫在文檔中。
注重細節。當你設計一個很復雜的算法的時候,你一定要把所有的詳細細設計都寫下來,沒有100頁不能罷休,段落要有5級以上,段落編號要有500個以上,例如:1.2.4.6.3.13 - Display all impacts for activity where selected mitigations can apply (short pseudocode omitted). 這樣,當你寫代碼的時候,你就可以讓你的代碼和文檔一致,如:Act1_2_4_6_3_13()
千萬不要注釋度衡單位。比如時間用的是秒還是毫秒,尺寸用的是像素還是英寸,大小是MB還是KB。等等。另外,在你的代碼里,你可以混用不同的度衡單位,但也不要注釋。
Gotchas。陷阱,千萬不要注釋代碼中的陷阱。
在注釋和文檔中發泄不滿。(參看本站的“五種應該避免的注釋”)
程序設計
Java Casts。Java的類型轉型是天賜之物。每一次當你從Collection里取到一個object的時候,你都需要把其轉回原來的類型。因些,這些轉型操作會出現在N多的地方。如果你改變了類型,那么你不一定能改變所有的地方。而編譯器可能能檢查到,也可能檢查不到。
利用Java的冗余。比如:Bubblegum b = new Bubblegom(); 和 swimmer = swimner + 1; 注意變量間的細微差別。
從不驗證。從不驗證輸入的數據,從不驗證函數的返回值。這樣做可以向大家展示你是多么的信任公司的設備和其它程序員。
不要封裝。調用者需要知道被調用的所有的細節。
克隆和拷貝。為了效率,你要學會使用copy + paste。你幾乎都不用理解別人的代碼,你就可以高效地編程了。(陳皓注:Copy + Paste出來的代碼bug多得不能再多)
巨大的listener。寫一個listener,然后讓你的所有的button類都使用這個listener,這樣你可以在這個listener中整出一大堆if…else…語句,相當的刺激。
使用三維數組。如果你覺得三維還不足夠,你可以試試四維。
混用。同時使用類的get/set方法和直接訪問那個public變量。這樣做的好處是可以極大的挫敗維護人員。
包裝,包裝,包裝。把你所有的API都包裝上6到8遍,包裝深度多達4層以上。然后包裝出相似的功能。
沒有秘密。把所有的成員都聲明成public的。這樣,你以后就很難限制其被人使用,而且這樣可以和別的代碼造成更多的耦合度,可以讓你的代碼存活得更久。
排列和阻礙。把drawRectangle(height, width) 改成 drawRectangle(width, height),等release了幾個版本后,再把其改回去。這樣維護程序的程序員們將不能很快地明白哪一個是對的。
把變量改在名字上。例如,把setAlignment(int alignment)改成,setLeftAlignment, setRightAlignment, setCenterAlignment。
Packratting。保留你所有的沒有使用的和陳舊的變量,方法和代碼。
That’s Final。Final你所有的子結點的類,這樣,當你做完這個項目后,沒有人可以通過繼承來擴展你的類。java.lang.String不也是這樣嗎?
避免使用接口。在java中,BS接口,在C++中BS使用虛函數。
避免使用layout。這樣就使得我們只能使用絕對坐標。如果你的老大強制你使用layout,你可以考慮使用GridBagLayout,然后把grid坐標hard code.
環境變量。如果你的代碼需要使用環境變量。(getenv() - C++ / System.getProperty() - Java ),那么,你應該把你的類的成員的初始化使用環境變量,而不是構造函數。
使用Magic number。參看《Linux一個插曲》。
使用全局變量。1)把全局變量的初始化放在不同的函數中,就算這個函數和這個變量沒有任何關系,這樣能夠讓我們的維護人員就像做偵探工作一樣。2)使用全局變量可以讓你的函數的參數變得少一些。
配置文件。配置文件主要用于一些參數的初始化。在編程中,我們可以讓配置文件中的參數名和實際程序中的名字不一樣。
膨脹你的類。讓你的類盡可能地擁有各種臃腫和晦澀的方法。比如,你的類只實現一種可能性,但是你要提供所有可能性的方法。不要定義其它的類,把所有的功能都放在一個類中。
使用子類。面向對象是寫出無法維護代碼的天賜之物。如果你有一個類有十個成為(變量和方法)你可以考慮寫10個層次的繼承,然后把這十個屬性分別放在這十個層次中。如果可能的話,把這十個類分別放在十個不同的文件中。
混亂你的代碼
使用XML。XML的強大是無人能及的。使用XML你可以把本來只要10行的代碼變成100行。而且,還要逼著別人也有XML。(參看,信XML得永生,信XML得自信)
混亂C代碼。在《如何加密源代碼》中已經說過一些方法了,這里再補充一些。
使用不同的進制。比如:10 和010不是一樣的。再比如:array = new int[]{ 111, 120, 013, 121,};
盡量使用void*。然后把其轉成各種類型
使用隱式的轉型。C++的構造函數可以讓你神不知鬼不覺得完成轉型。
分解條件表達式。如:把 a==100分解成,a>99 && a<101
學會利用分號。如:if ( a );else;{ int d; d = c;}
間接轉型。如:把double轉string,寫成new Double(d).toString() 而不是 Double.toString(d)
大量使用嵌套。一個NB的程序員可以在一行代碼上使用超過10層的小括號(),或是在一個函數里使用超過20層的語句嵌套{},把嵌套的if else 轉成 [? :] 也是一件很NB的事。
使用C的變種數組。myArray[i] 可以變成*(myArray + i) 也可以變成 *(i + myArray) 其等價于 i[myArray]。再看一個函數調用的示例,函數聲明:int myfunc(int q, int p) { return p%q; } 函數調用myfunc(6291, 8)[Array];
長代碼行。一行的代碼越長越好。這樣別人閱讀時就需要來來回回的
不要較早的return。不要使用goto,不要使用break,這樣,你就需要至少5層以上的if-else來處理錯誤。
原文轉自:http://blogread.cn/it/article/3859?f=wb