譯者：陳皓 （@左耳朵耗子）

譯文：http://coolshell.cn/articles/4758.html

?

對，你沒看錯，本文就是教你怎么寫出讓同事無法維護的代碼。

一、程序命名

容易輸入的變量名。比如：Fred，asdf

單字母的變量名。比如：a，b，c，x，y，z（如果不夠用，可以考慮 a1，a2，a3，a4，….）

有創意地拼寫錯誤。比如：SetPintleOpening， SetPintalClosing，這樣可以讓人很難搜索代碼。

抽象。比如：ProcessData，DoIt，GetData… 抽象到就跟什么都沒說一樣。

縮寫。比如：WTF，RTFSC …… （使用拼音縮寫也同樣給力，比如： BT，TMD，TJJTDS）

隨機大寫字母。比如：gEtnuMbER..

重用命名。在內嵌的語句塊中使用相同的變量名有奇效。

使用重音字母。比如：int ínt（第二個 ínt 不是 int ）

使用下劃線。比如：_， __， ___。

使用不同的語言。比如混用英語，德語，或是中文拼音。

使用字符命名。比如：slash, asterix, comma…

使用無關的單詞。比如：god, superman, iloveu….

混淆l和1。字母 l 和數字 1 有時候是看不出來的。

二、偽裝欺詐

?

把注釋和代碼交織在一起。

for(j=0; j<array_len; j+ =8){ total += array[j+0 ]; total += array[j+1 ]; total += array[j+2 ]; /* Main body of total += array[j+3]; * loop is unrolled total += array[j+4]; * for greater speed. total += array[j+5]; */ total += array[j+6 ]; total += array[j+7 ];}

代碼和顯示不一致。比如，你的界面顯示叫 postal code，但是代碼里確叫 zipcode。

隱藏全局變量。把使用全局變量以函數參數的方式傳遞給函數，這樣可以讓人覺得那個變量不是全局變量。

使用相似的變量名。如：單詞相似，swimmer 和 swimner，字母相似：ilI1| 或 oO08，parselnt 和 parseInt， D0Calc 和 DOCalc，還有這一組：xy_Z, xy__z, _xy_z, _xyz, XY_Z, xY_z, Xy_z。

重載函數。使用相同的函數名，但是其功能和具體實現完全沒有關系。

操作符重載。重載操作符可以讓你的代碼變得詭異，感謝 CCTV，感謝 C++，這個東西是可以把混亂代碼提高到一種藝術的形式。

?

比如：重載一個類的 ! 操作符，但實際功能并不是取反，讓其返回一個整數。

于是，如果你使用 ! ! 操作符，那么，有意思的事就發生了—— 先是調用類的重載 ! 操作符，然后把其返回的整數給 ! 成了 布爾變量，如果是 !!! 呢？呵呵。

三、文檔和注釋

在注釋中撒謊。你不用真的去撒謊，只需在改代碼的時候不要更新注釋就可以了。

注釋里面寫廢話。比如：/* add 1 to i */

只注釋是什么，而不是為什么。

不要注釋秘密。如果你開發一個航班系統，請你一定要保證每有一個新的航班被加入，就得要修改 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 的類型轉型是天賜之物，每一次當你從 Collectio n里取到一個 object 的時候，你都需要把其轉回原來的類型。

因些，這些轉型操作會出現在 N 多的地方。

如果你改變了類型，那么你不一定能改變所有的地方。而編譯器可能能檢查到，也可能檢查不到。

利用 Java 的冗余。比如：Bubblegum b = new Bubblegom(); 和 swimmer = swimner + 1; 注意變量間的細微差別。

從不驗證。從不驗證輸入的數據，從不驗證函數的返回值。這樣做可以向大家展示你是多么的信任公司的設備和其它程序員

不要封裝。調用者需要知道被調用的所有的細節。

克隆和拷貝。為了效率，你要學會使用 copy + past，你幾乎都不用理解別人的代碼，你就可以高效地編程了。

巨大的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。

保留你所有的沒有使用的和陳舊的變量，方法和代碼。

Final 你所有的子結點的類，這樣，當你做完這個項目后，沒有人可以通過繼承來擴展你的類。java.lang.String 不也是這樣嗎？

避免使用 layout。這樣就使得我們只能使用絕對坐標，如果你的老大強制你使用 layout，你可以考慮使用 GridBagLayout，然后把 grid 坐標 hard code。

環境變量。如果你的代碼需要使用環境變量，那么，你應該把你的類的成員的初始化使用環境變量，而不是構造函數。

使用全局變量。1）把全局變量的初始化放在不同的函數中，就算這個函數和這個變量沒有任何關系，這樣能夠讓我們的維護人員就像做偵探工作一樣。2）使用全局變量可以讓你的函數的參數變得少一些。

配置文件。配置文件主要用于一些參數的初始化，在編程中，我們可以讓配置文件中的參數名和實際程序中的名字不一樣。

膨脹你的類。讓你的類盡可能地擁有各種臃腫和晦澀的方法，比如，你的類只實現一種可能性，但是你要提供所有可能性的方法。不要定義其它的類，把所有的功能都放在一個類中。

使用子類。面向對象是寫出無法維護代碼的天賜之物，如果你有一個類有十個成為（變量和方法）你可以考慮寫 10 個層次的繼承，然后把這十個屬性分別放在這十個層次中。如果可能的話，把這十個類分別放在十個不同的文件中。

混亂你的代碼。使用 XML，XML 的強大是無人能及的，使用 XML 你可以把本來只要 10 行的代碼變成 100 行。而且，還要逼著別人也有 XML。（參看，信 XML 得永生，信 XML 得自信）

分解條件表達式。如：把 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 的事。

長代碼行。一行的代碼越長越好，這樣別人閱讀時就需要來來回回的。

不要過早的return。不要使用 break，這樣，你就需要至少 5 層以上的 if-else 來處理錯誤。

不要使用{}。不要在 if else 使用{}，尤其是在你重量地使用 if-else 嵌套時，你甚至可以在其中亂縮進代碼，這樣一來，就算是最有經驗的程序員也會踩上陷阱。

瑣碎的封裝。比較封裝一個 bool 類，類里面什么都做，就是一個 bool。

循環。千萬不可用 for(int i=0; i<n; i++) 使用 while 代替 for，交換 n 和 i，把 < 改成 <=，使用 i– 調整步伐 。

五、測試

從不測試。千萬不要測試任何的出錯處理，從來也不檢測系統調用的返回值。

永遠不做性能測試。如果不夠快就告訴用戶換一個更快的機器。如果你一做測試，那么就可能會要改你的算法，甚至重設計，重新架構。

不要寫測試案例。不要做什么代碼覆蓋率測試，自動化測試。

測試是懦夫行為。一個勇敢的程序員是根本不需要這一步的，太多的程序太害怕他們的老板，害怕失去工作，害怕用戶抱怨，甚至被起訴，這種擔心害怕直接影響了生產力。

如果你對你的代碼有強大的信心，那還要什么測試呢？真正的程序員是不需要測試自己的代碼的。

六、其他

你的老板什么都知道。無論你的老板有多 SB，你都要嚴格地遵照他的旨意辦事，這樣一來，你會學到更多的知識以及如何寫出更加無法維護的代碼。

顛覆Help Desk。你要確保你那滿是 bug 的程序永遠不要被維護團隊知道。當用戶打電話和寫郵件給你的時候，你就不要理會，就算要理會，讓用戶重做系統或是告訴用戶其帳號有問題，是標準的回答。

閉嘴。對于一些像 y2k 這樣的大 bug，你要學會守口如瓶，不要告訴任何人，包括你的親人好友以及公司的同事和管理層，這樣當到那一天的時候，你就可以用這個 bug 掙錢了。

忽悠。你會學會忽悠，就算你的代碼寫得很爛，你也要為其掛上 GoF 設計模式的標簽，就算你的項目做得再爛，你也要為其掛上敏捷的標簽，讓整個團隊和公司，甚至整個業界都開始躁動，這樣才能真正為難維護的代碼鋪平道路。

總之，我們的口號是——?Write Everywhere, Read Nowhere

?

·END·

程序員的成長之路

路雖遠，行則必至

創作挑戰賽新人創作獎勵來咯，堅持創作打卡瓜分現金大獎

總結

以上是生活随笔為你收集整理的【转】如何写出让同事无法维护的代码的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。