如何寫出讓同事無法維護(hù)的代碼召边?

對(duì)铺呵,你沒看錯(cuò)裹驰,本文就是教你怎么寫出讓同事無法維護(hù)的代碼。

一片挂、程序命名

  • 容易輸入的變量名幻林。比如:Fred,asdf

  • 單字母的變量名音念。比如:a,b,c, x,y,z(如果不夠用沪饺,可以考慮a1,a2,a3,a4,….)

  • 有創(chuàng)意地拼寫錯(cuò)誤。比如:SetPintleOpening闷愤, SetPintalClosing整葡。這樣可以讓人很難搜索代碼。

  • 抽象讥脐。比如:ProcessData, DoIt, GetData… 抽象到就跟什么都沒說一樣遭居。

  • 縮寫。比如:WTF旬渠,RTFSC …… (使用拼音縮寫也同樣給力俱萍,比如:BT,TMD告丢,TJJTDS)

  • 隨機(jī)大寫字母枪蘑。比如:gEtnuMbER..

  • 重用命名。在內(nèi)嵌的語句塊中使用相同的變量名有奇效。

  • 使用重音字母岳颇。比如:int ínt(第二個(gè) ínt不是int)

  • 使用下劃線照捡。比如:_, __, ___。

  • 使用不同的語言话侧。比如混用英語麻敌,德語,或是中文拼音掂摔。

  • 使用字符命名术羔。比如:slash, asterix, comma…

  • 使用無關(guān)的單詞。比如:god, superman, iloveu….

  • 混淆l和1乙漓。字母l和數(shù)字1有時(shí)候是看不出來的级历。

二、偽裝欺詐

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

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.

  • 隱藏全局變量嚼贡。把使用全局變量以函數(shù)參數(shù)的方式傳遞給函數(shù),這樣可以讓人覺得那個(gè)變量不是全局變量同诫。
    使用相似的變量名粤策。如:?jiǎn)卧~相似,swimmer 和 swimner误窖,字母相似:ilI1| 或 oO08叮盘。parselnt 和 parseInt, D0Calc 和 DOCalc霹俺。還有這一組:xy_Z, xy__z, _xy_z, _xyz, XY_Z, xY_z, Xy_z柔吼。

  • 重載函數(shù)。使用相同的函數(shù)名丙唧,但是其功能和具體實(shí)現(xiàn)完全沒有關(guān)系愈魏。
    操作符重載。重載操作符可以讓你的代碼變得詭異想际,感謝CCTV培漏,感謝C++。這個(gè)東西是可以把混亂代碼提高到一種藝術(shù)的形式沼琉。比如:重載一個(gè)類的 ! 操作符北苟,但實(shí)際功能并不是取反,讓其返回一個(gè)整數(shù)打瘪。于是友鼻,如果你使用 ! ! 操作符傻昙,那么,有意思的事就發(fā)生了—— 先是調(diào)用類的重載 ! 操作符彩扔,然后把其返回的整數(shù)給 ! 成了 布爾變量妆档,如果是 !!! 呢?呵呵虫碉。

三贾惦、文檔和注釋

  • 在注釋中撒謊。你不用真的去撒謊敦捧,只需在改代碼的時(shí)候不要更新注釋就可以了须板。

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

  • 只注釋是什么兢卵,而不是為什么习瑰。

  • 不要注釋秘密。如果你開發(fā)一個(gè)航班系統(tǒng)秽荤,請(qǐng)你一定要保證每有一個(gè)新的航班被加入甜奄,就得要修改25個(gè)以上的位置的程序。千萬別把這個(gè)事寫在文檔中窃款。

  • 注重細(xì)節(jié)课兄。當(dāng)你設(shè)計(jì)一個(gè)很復(fù)雜的算法的時(shí)候,你一定要把所有的詳細(xì)細(xì)設(shè)計(jì)都寫下來晨继,沒有100頁不能罷休烟阐,段落要有5級(jí)以上,段落編號(hào)要有500個(gè)以上踱稍,例如:1.2.4.6.3.13 – Display all impacts for activity where selected mitigations can apply (short pseudocode omitted). 這樣曲饱,當(dāng)你寫代碼的時(shí)候,你就可以讓你的代碼和文檔一致珠月,如:Act1_2_4_6_3_13()千萬不要注釋度衡單位。比如時(shí)間用的是秒還是毫秒楔敌,尺寸用的是像素還是英寸啤挎,大小是MB還是KB。等等卵凑。另外庆聘,在你的代碼里,你可以混用不同的度衡單位勺卢,但也不要注釋伙判。

  • Gotchas。陷阱黑忱,千萬不要注釋代碼中的陷阱宴抚。

  • 在注釋和文檔中發(fā)泄不滿勒魔。

四、程序設(shè)計(jì)

  • Java Casts菇曲。Java的類型轉(zhuǎn)型是天賜之物冠绢。每一次當(dāng)你從Collection里取到一個(gè)object的時(shí)候,你都需要把其轉(zhuǎn)回原來的類型常潮。因些弟胀,這些轉(zhuǎn)型操作會(huì)出現(xiàn)在N多的地方。如果你改變了類型喊式,那么你不一定能改變所有的地方孵户。而編譯器可能能檢查到,也可能檢查不到岔留。

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

  • 從不驗(yàn)證贸诚。從不驗(yàn)證輸入的數(shù)據(jù)方庭,從不驗(yàn)證函數(shù)的返回值。這樣做可以向大家展示你是多么的信任公司的設(shè)備和其它程序員
    不要封裝酱固。調(diào)用者需要知道被調(diào)用的所有的細(xì)節(jié)械念。

  • 克隆和拷貝。為了效率运悲,你要學(xué)會(huì)使用copy + paste龄减。你幾乎都不用理解別人的代碼,你就可以高效地編程了班眯。

  • 巨大的listener希停。寫一個(gè)listener,然后讓你的所有的button類都使用這個(gè)listener署隘,這樣你可以在這個(gè)listener中整出一大堆if…else…語句宠能,相當(dāng)?shù)拇碳ぁ?/p>

  • 使用三維數(shù)組。如果你覺得三維還不足夠磁餐,你可以試試四維违崇。

  • 混用。同時(shí)使用類的get/set方法和直接訪問那個(gè)public變量诊霹。這樣做的好處是可以極大的挫敗維護(hù)人員羞延。

  • 包裝,包裝脾还,包裝伴箩。把你所有的API都包裝上6到8遍,包裝深度多達(dá)4層以上鄙漏。然后包裝出相似的功能嗤谚。

  • 沒有秘密棺蛛。把所有的成員都聲明成public的。這樣呵恢,你以后就很難限制其被人使用鞠值,而且這樣可以和別的代碼造成更多的耦合度,可以讓你的代碼存活得更久渗钉。

  • 排列和阻礙彤恶。把drawRectangle(height, width) 改成 drawRectangle(width, height),等release了幾個(gè)版本后鳄橘,再把其改回去声离。這樣維護(hù)程序的程序員們很快就不明白哪一個(gè)是對(duì)的。

  • 把變量改在名字上瘫怜。例如术徊,把setAlignment(int alignment)改成,setLeftAlignment, setRightAlignment, setCenterAlignment鲸湃。

  • 保留你所有的沒有使用的和陳舊的變量赠涮,方法和代碼。

  • Final你所有的子結(jié)點(diǎn)的類暗挑,這樣笋除,當(dāng)你做完這個(gè)項(xiàng)目后,沒有人可以通過繼承來擴(kuò)展你的類炸裆。java.lang.String不也是這樣嗎垃它?

  • 避免使用layout。這樣就使得我們只能使用絕對(duì)坐標(biāo)烹看。如果你的老大強(qiáng)制你使用layout国拇,你可以考慮使用GridBagLayout,然后把grid坐標(biāo)hard code.

  • 環(huán)境變量惯殊。如果你的代碼需要使用環(huán)境變量酱吝。那么,你應(yīng)該把你的類的成員的初始化使用環(huán)境變量靠胜,而不是構(gòu)造函數(shù)掉瞳。
    使用全局變量。1)把全局變量的初始化放在不同的函數(shù)中浪漠,就算這個(gè)函數(shù)和這個(gè)變量沒有任何關(guān)系,這樣能夠讓我們的維護(hù)人員就像做偵探工作一樣霎褐。2)使用全局變量可以讓你的函數(shù)的參數(shù)變得少一些址愿。

  • 配置文件。配置文件主要用于一些參數(shù)的初始化冻璃。在編程中响谓,我們可以讓配置文件中的參數(shù)名和實(shí)際程序中的名字不一樣损合。

  • 膨脹你的類.讓你的類盡可能地?fù)碛懈鞣N臃腫和晦澀的方法。比如娘纷,你的類只實(shí)現(xiàn)一種可能性嫁审,但是你要提供所有可能性的方法。不要定義其它的類赖晶,把所有的功能都放在一個(gè)類中律适。

  • 使用子類。面向?qū)ο笫菍懗鰺o法維護(hù)代碼的天賜之物遏插。如果你有一個(gè)類有十個(gè)成為(變量和方法)你可以考慮寫10個(gè)層次的繼承捂贿,然后把這十個(gè)屬性分別放在這十個(gè)層次中。如果可能的話胳嘲,把這十個(gè)類分別放在十個(gè)不同的文件中厂僧。

  • 混亂你的代碼。使用XML了牛。XML的強(qiáng)大是無人能及的颜屠。使用XML你可以把本來只要10行的代碼變成100行。而且鹰祸,還要逼著別人也有XML甫窟。(參看,信XML得永生福荸,信XML得自信)

  • 分解條件表達(dá)式蕴坪。如:把 a==100分解成,a>99 && a<101

  • 學(xué)會(huì)利用分號(hào)敬锐。如:if ( a );else;{ int d; d = c;}

  • 間接轉(zhuǎn)型背传。如:把double轉(zhuǎn)string,寫成new Double(d).toString() 而不是 Double.toString(d)

  • 大量使用嵌套台夺。一個(gè)NB的程序員可以在一行代碼上使用超過10層的小括號(hào)()径玖,或是在一個(gè)函數(shù)里使用超過20層的語句嵌套{},把嵌套的if else 轉(zhuǎn)成 [? :] 也是一件很NB的事颤介。

  • 長(zhǎng)代碼行梳星。一行的代碼越長(zhǎng)越好。這樣別人閱讀時(shí)就需要來來回回的

  • 不要過早的return滚朵。不要使用break冤灾,這樣,你就需要至少5層以上的if-else來處理錯(cuò)誤辕近。

  • 不要使用{}韵吨。不要在if else使用{},尤其是在你重量地使用if-else嵌套時(shí)移宅,你甚至可以在其中亂縮進(jìn)代碼归粉,這樣一來椿疗,就算是最有經(jīng)驗(yàn)的程序員也會(huì)踩上陷阱。

  • 瑣碎的封裝糠悼。比較封裝一個(gè)bool類届榄,類里面什么都做,就是一個(gè)bool.

  • 循環(huán)倔喂。千萬不可用for(int i=0; i<n; i++)使用while代替for铝条,交換n和i,把<改成<=滴劲,使用 i–調(diào)整步伐 攻晒。

五、測(cè)試

  • 從不測(cè)試班挖。千萬不要測(cè)試任何的出錯(cuò)處理鲁捏,從來也不檢測(cè)系統(tǒng)調(diào)用的返回值。

  • 永遠(yuǎn)不做性能測(cè)試萧芙。如果不夠快就告訴用戶換一個(gè)更快的機(jī)器给梅。如果你一做測(cè)試,那么就可能會(huì)要改你的算法双揪,甚至重設(shè)計(jì)动羽,重新架構(gòu)。

  • 不要寫測(cè)試案例渔期。不要做什么代碼覆蓋率測(cè)試运吓,自動(dòng)化測(cè)試。

  • 測(cè)試是懦夫行為疯趟。一個(gè)勇敢的程序員是根本不需要這一步的拘哨。太多的程序太害怕他們的老板,害怕失去工作信峻,害怕用戶抱怨倦青,甚至被起訴。這種-- 擔(dān)心害怕直接影響了生產(chǎn)力盹舞。如果你對(duì)你的代碼有強(qiáng)大的信心产镐,那還要什么測(cè)試呢?真正的程序員是不需要測(cè)試自己的代碼的踢步。

六癣亚、其他

  • 你的老板什么都知道。無論你的老板有多SB获印,你都要嚴(yán)格地遵照他的旨意辦事逃糟,這樣一來,你會(huì)學(xué)到更多的知識(shí)以及如何寫出更加無法維護(hù)的代碼蓬豁。

  • 顛覆Help Desk绰咽。你要確保你那滿是bug的程序永遠(yuǎn)不要被維護(hù)團(tuán)隊(duì)知道。當(dāng)用戶打電話和寫郵件給你的時(shí)候地粪,你就不要理會(huì)取募,就算要理會(huì),讓用戶重做系統(tǒng)或是告訴用戶其帳號(hào)有問題蟆技,是標(biāo)準(zhǔn)的回答玩敏。

  • 閉嘴。對(duì)于一些像y2k這樣的大bug质礼,你要學(xué)會(huì)守口如瓶旺聚,不要告訴任何人,包括你的親人好友以及公司的同事和管理層眶蕉,這樣當(dāng)?shù)侥且惶斓臅r(shí)候砰粹,你就可以用這個(gè)bug掙錢了。

  • 忽悠造挽。你會(huì)學(xué)會(huì)忽悠碱璃,就算你的代碼寫得很爛,你也要為其掛上GoF設(shè)計(jì)模式的標(biāo)簽饭入,就算你的項(xiàng)目做得再爛嵌器,你也要為其掛上敏捷的標(biāo)簽,讓整個(gè)團(tuán)隊(duì)和公司谐丢,甚至整個(gè)業(yè)界都開始躁動(dòng)爽航,這樣才能真正為難維護(hù)的代碼鋪平道路。

總之乾忱,我們的口號(hào)是—— Write Everywhere, Read Nowhere

原文:http://mindprod.com/jgloss/unmain.html
譯者:陳皓 (@左耳朵耗子)
譯文:http://coolshell.cn/articles/4758.html

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末讥珍,一起剝皮案震驚了整個(gè)濱河市,隨后出現(xiàn)的幾起案子饭耳,更是在濱河造成了極大的恐慌串述,老刑警劉巖,帶你破解...
    沈念sama閱讀 216,372評(píng)論 6 498
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件寞肖,死亡現(xiàn)場(chǎng)離奇詭異纲酗,居然都是意外死亡,警方通過查閱死者的電腦和手機(jī)新蟆,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 92,368評(píng)論 3 392
  • 文/潘曉璐 我一進(jìn)店門觅赊,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人琼稻,你說我怎么就攤上這事吮螺。” “怎么了?”我有些...
    開封第一講書人閱讀 162,415評(píng)論 0 353
  • 文/不壞的土叔 我叫張陵鸠补,是天一觀的道長(zhǎng)萝风。 經(jīng)常有香客問我,道長(zhǎng)紫岩,這世上最難降的妖魔是什么规惰? 我笑而不...
    開封第一講書人閱讀 58,157評(píng)論 1 292
  • 正文 為了忘掉前任,我火速辦了婚禮泉蝌,結(jié)果婚禮上歇万,老公的妹妹穿的比我還像新娘。我一直安慰自己勋陪,他們只是感情好贪磺,可當(dāng)我...
    茶點(diǎn)故事閱讀 67,171評(píng)論 6 388
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著诅愚,像睡著了一般寒锚。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上呻粹,一...
    開封第一講書人閱讀 51,125評(píng)論 1 297
  • 那天壕曼,我揣著相機(jī)與錄音,去河邊找鬼等浊。 笑死腮郊,一個(gè)胖子當(dāng)著我的面吹牛,可吹牛的內(nèi)容都是我干的筹燕。 我是一名探鬼主播轧飞,決...
    沈念sama閱讀 40,028評(píng)論 3 417
  • 文/蒼蘭香墨 我猛地睜開眼,長(zhǎng)吁一口氣:“原來是場(chǎng)噩夢(mèng)啊……” “哼撒踪!你這毒婦竟也來了过咬?” 一聲冷哼從身側(cè)響起,我...
    開封第一講書人閱讀 38,887評(píng)論 0 274
  • 序言:老撾萬榮一對(duì)情侶失蹤制妄,失蹤者是張志新(化名)和其女友劉穎掸绞,沒想到半個(gè)月后,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體耕捞,經(jīng)...
    沈念sama閱讀 45,310評(píng)論 1 310
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡衔掸,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 37,533評(píng)論 2 332
  • 正文 我和宋清朗相戀三年,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了俺抽。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片敞映。...
    茶點(diǎn)故事閱讀 39,690評(píng)論 1 348
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡,死狀恐怖磷斧,靈堂內(nèi)的尸體忽然破棺而出振愿,到底是詐尸還是另有隱情捷犹,我是刑警寧澤,帶...
    沈念sama閱讀 35,411評(píng)論 5 343
  • 正文 年R本政府宣布冕末,位于F島的核電站萍歉,受9級(jí)特大地震影響,放射性物質(zhì)發(fā)生泄漏栓霜。R本人自食惡果不足惜翠桦,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 41,004評(píng)論 3 325
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望胳蛮。 院中可真熱鬧,春花似錦丛晌、人聲如沸仅炊。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,659評(píng)論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽抚垄。三九已至,卻和暖如春谋逻,著一層夾襖步出監(jiān)牢的瞬間呆馁,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 32,812評(píng)論 1 268
  • 我被黑心中介騙來泰國(guó)打工毁兆, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留浙滤,地道東北人。 一個(gè)月前我還...
    沈念sama閱讀 47,693評(píng)論 2 368
  • 正文 我出身青樓气堕,卻偏偏與公主長(zhǎng)得像纺腊,于是被迫代替她去往敵國(guó)和親。 傳聞我的和親對(duì)象是個(gè)殘疾皇子茎芭,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 44,577評(píng)論 2 353

推薦閱讀更多精彩內(nèi)容