代碼整潔之道讀書(shū)筆記課件

讀書(shū)交流會(huì)

多讀書(shū)

好讀書(shū)

讀好書(shū) 讀書(shū)交流會(huì)

多讀書(shū)

好讀書(shū)

讀好書(shū)舉頭望明月低頭敲代碼滿(mǎn)園春色關(guān)不住一串代碼飄出來(lái)夜闌臥聽(tīng)風(fēng)雨聲做夢(mèng)還在敲代碼洛陽(yáng)親友如相問(wèn)就說(shuō)我在敲代碼風(fēng)蕭蕭兮易水寒壯士要去敲代碼松下問(wèn)童子言師敲代碼白發(fā)三千丈Bug改不完垂死病中驚坐起今天還沒(méi)敲代碼在天愿做比翼鳥(niǎo)在地愿意敲代碼但愿人長(zhǎng)久天天敲代碼獻(xiàn)給廣大不辭辛勞的程序員們舉頭望明月獻(xiàn)給廣大不辭辛勞的程序員們閱讀本書(shū)有兩種原因第一，你是個(gè)程序員第二，你想成為更好的程序員閱讀本書(shū)有兩種原因主要內(nèi)容混亂代碼的代價(jià)整潔代碼藝術(shù)、什么是整潔代碼如何編寫(xiě)整潔代碼主要內(nèi)容混亂代碼的代價(jià)混亂代碼的代價(jià)YourTextHereYourTextHere一、要有代碼

有人說(shuō)過(guò)我們正在臨近代碼的終結(jié)點(diǎn)。快代碼就會(huì)自動(dòng)產(chǎn)生出來(lái)不需要再人工編寫(xiě)。程序員完全沒(méi)用了因?yàn)樯虅?wù)人士可以從規(guī)約直接生成程序。

代碼呈現(xiàn)了需求的細(xì)節(jié)。混亂代碼的代價(jià)YourTextHereYourText混亂代碼的代價(jià)二、糟糕代碼

你是否曾為糟糕的代碼所深深困擾？如果你是位有點(diǎn)兒經(jīng)驗(yàn)的程序員，定然多次遇到過(guò)這類(lèi)困境。我們有專(zhuān)用來(lái)形容這事的詞：沼澤。我們趟過(guò)代碼的水域。我們穿過(guò)灌木密布、瀑布暗藏的沼澤地。我們拼命想找到出路，期望有點(diǎn)什么線(xiàn)索能啟發(fā)我們到底發(fā)生了什么事，但目光所及，只是越來(lái)越多死氣沉沉的代碼。混亂代碼的代價(jià)二、糟糕代碼混亂代碼的代價(jià)隨著混亂的增加，團(tuán)隊(duì)生產(chǎn)力也持續(xù)下降趨向于零。當(dāng)生產(chǎn)力下降時(shí)，管理層就只有一件事可做了，增加更多人手到項(xiàng)目中，期望提升生產(chǎn)力?？墒切氯瞬⒉皇煜は到y(tǒng)的設(shè)計(jì)。他們搞不清楚什么樣的修改符合設(shè)計(jì)意圖，什么樣的修改違背設(shè)計(jì)意圖。而且，他們以及團(tuán)隊(duì)中的其他人都背負(fù)著提升生產(chǎn)力的可怕壓力。于是，他們制造更多的混亂，驅(qū)動(dòng)生產(chǎn)力向零那端不斷下降?；靵y代碼的代價(jià)隨著混亂的增加，團(tuán)隊(duì)生產(chǎn)力也持續(xù)下混亂代碼的代價(jià)將需求明確到機(jī)器可以執(zhí)行的程度，就是編程要做的事，這種規(guī)約就是代碼。糟糕的代碼可能毀掉一家公司?；靵y代碼的代價(jià)是驅(qū)動(dòng)生產(chǎn)力不斷趨向零。整潔不僅與效率有關(guān)，而且關(guān)于企業(yè)的生存。

什么樣的代碼是整潔代碼？混亂代碼的代價(jià)將需求明確到機(jī)器可以執(zhí)行的程度，就是編程要做的整潔代碼代碼邏輯應(yīng)當(dāng)直截了當(dāng)，叫缺陷難以隱藏，盡量減少依賴(lài)關(guān)系，使之便于維護(hù)，依據(jù)某種分層戰(zhàn)略完善錯(cuò)誤處理代碼，性能調(diào)至最優(yōu)，省得引誘別人做沒(méi)規(guī)矩的優(yōu)。整潔的代碼簡(jiǎn)單直接。整潔的代碼如同優(yōu)美的散文。整潔的代碼從不隱藏設(shè)計(jì)者的意圖，充滿(mǎn)了干凈利落的抽象和直截了當(dāng)?shù)目刂普Z(yǔ)句。果斷決絕。代碼應(yīng)當(dāng)講述事實(shí)不引人猜測(cè)。它只該包含必需之物。它應(yīng)當(dāng)有單元測(cè)試和驗(yàn)收測(cè)試。它使用有意義的命名。它只提供一種而非多種做一件事的途徑。它只有盡量少的依賴(lài)關(guān)系而且要明確地定義和提供清晰、盡量少的API。代碼應(yīng)通過(guò)其字面表達(dá)含義因?yàn)椴煌恼Z(yǔ)言導(dǎo)致并非所有必需信息均可通過(guò)代碼自身清晰表達(dá)。整潔代碼代碼邏輯應(yīng)當(dāng)直截了當(dāng)，叫缺陷難以隱藏，盡量減少依賴(lài)關(guān)整潔代碼沒(méi)有測(cè)試的代碼不干凈。不管它有多優(yōu)雅不管有多可讀、多易理解微乎測(cè)試其不潔亦可知也。整潔的代碼總是看起來(lái)像是某位特別在意它的人寫(xiě)的。幾乎沒(méi)有改進(jìn)的余地。代碼作者什么都想到了如果你企圖改進(jìn)它總會(huì)回到原點(diǎn)。能通過(guò)所有測(cè)試；沒(méi)有重復(fù)代碼；體現(xiàn)系統(tǒng)中的全部設(shè)計(jì)理念；包括盡量少的實(shí)體，比如類(lèi)、方法、函數(shù)等。整潔代碼沒(méi)有測(cè)試的代碼不干凈。不管它有多優(yōu)雅不管有多可讀、如何編寫(xiě)整潔代碼命名函數(shù)注釋類(lèi)如何編寫(xiě)整潔代碼命名命名一、要“名副其實(shí)” a、這件事情要嚴(yán)肅對(duì)待。

在起一個(gè)表意的名字上花時(shí)間是值得的，優(yōu)秀程序員從細(xì)節(jié)做起。 b、如果名稱(chēng)需要注釋來(lái)補(bǔ)充，那就不是“名副其實(shí)”。 Demo：intd;//消逝的時(shí)間，以天計(jì)算

應(yīng)該使用指明計(jì)量對(duì)象和計(jì)量單位的名稱(chēng)。 IntelapsedTimeInDays; IntdaysSinceCreation; IntdaysSinceModificatin; IntfileAgeInDays’命名一、要“名副其實(shí)”命名c、問(wèn)題不在于代碼的簡(jiǎn)潔度，而在于代碼的“模糊度”。

這里的意思是簡(jiǎn)短的代碼，如果不能表達(dá)含義，也是不能做到“名副其實(shí)”。 Demo: Java:pulicList<int[]>getThem(){ List<int[]>list1=newArrayList<int[]>(); For(int[]x:theList) If(x[0]==4) list1.add(x); returnlist1; }

這里的代碼夠簡(jiǎn)單了，但是沒(méi)人知道theList是什么東西、theList[0]的意思是什么、d、是什么意義、以及返回list1該怎么用。

這就是作者所說(shuō)的“模糊度”，因?yàn)橐饬x比較模糊，所以這些代碼也不“名副其實(shí)”。那么怎么呢？應(yīng)該根據(jù)這段代碼的意圖來(lái)修改這里的函數(shù)名，變量名，值的含義（用常量）。命名c、問(wèn)題不在于代碼的簡(jiǎn)潔度，而在于代碼的“模糊度”。命名二、命名要避免誤導(dǎo)

程序員必須避免留下掩藏代碼本意的錯(cuò)誤線(xiàn)索。 Demo:accountList這個(gè)名字就不太好，因?yàn)閘ist這詞在java中是一個(gè)類(lèi)型，如果這個(gè)名字表達(dá)的類(lèi)型或者含義不是list就不應(yīng)該這樣命名。命名二、命名要避免誤導(dǎo)命名三、做有意義的區(qū)分

a、不要用數(shù)字命名， Demo:a1,a2,a3。b、話(huà)是另一種沒(méi)有意義的區(qū)分， Demo：如有有一個(gè)類(lèi)叫Product類(lèi)，那么ProductInfo與ProctductData就是沒(méi)有意義的區(qū)分，因?yàn)樗鼈兒x幾乎一樣。c、使用讀得出來(lái)的名字d、使用搜索得出來(lái)的名字e、接口和實(shí)現(xiàn) Demo:IShapeFactory和SharpFactory之間，選擇后者作為接口名命名三、做有意義的區(qū)分函數(shù)

函數(shù)的第一條規(guī)則是要短小，第二條規(guī)則還是要短小。40年的經(jīng)驗(yàn)告訴作者，函數(shù)就是要短小。20行封頂最佳。每個(gè)函數(shù)都一目了然，每個(gè)函數(shù)都做一件事。而且每個(gè)函數(shù)都依序把你帶到下一個(gè)函數(shù)，這就是函數(shù)應(yīng)該達(dá)到的短小程度。函數(shù)函數(shù)的第一條規(guī)則是要短小，第二條規(guī)則還是要短小。40年函數(shù)二、只做一件事

函數(shù)所做的事情都在一個(gè)抽象層級(jí)，叫“只做一件事”。如果各個(gè)層級(jí)抽象混雜在一起，顯然就做了不止一件事了函數(shù)二、只做一件事函數(shù)三、每個(gè)函數(shù)一個(gè)抽象層級(jí)函數(shù)中混雜不同的抽象層級(jí)，往往讓人迷惑。讀者無(wú)法判斷哪些是基礎(chǔ)概念哪些是細(xì)節(jié)。讀者無(wú)法提綱挈領(lǐng)的代價(jià)是，它無(wú)法快速學(xué)習(xí)，快速理解。從而為更多的bug埋下隱患。函數(shù)三、每個(gè)函數(shù)一個(gè)抽象層級(jí)函數(shù)四、使用描述性名稱(chēng)Demo:testtableHtmlSetupTeardownIncluder.render。如果長(zhǎng)一點(diǎn)的名稱(chēng)可以更加清晰，不要猶豫，用清晰的吧。函數(shù)四、使用描述性名稱(chēng)函數(shù)五、函數(shù)參數(shù)最好是0，其次是1，再次是2，避免3個(gè)及以上的參數(shù)個(gè)數(shù)。參數(shù)過(guò)多會(huì)使得客戶(hù)程序員上手的代價(jià)加大，優(yōu)秀代碼的可能性降低。函數(shù)五、函數(shù)參數(shù)函數(shù)五、抽離Try/Catch代碼將try/catch代碼隔離出來(lái)，避免影響主程序邏輯。Demo:Try{ DeletePage(page);//DeletePage是一個(gè)方法}Catch(Exceptione){LogError(e);//LogError是一個(gè)方法}

錯(cuò)誤處理就是一件事。函數(shù)五、抽離Try/Catch代碼注釋什么也比不上放置良好的注釋來(lái)的有用。什么也比不上亂七八糟的注釋更有本事搞亂一個(gè)模塊。什么也不會(huì)比陳舊、提供錯(cuò)誤信息的注釋更有破壞性。注釋并不像辛德勒的名單。他們并不“純?nèi)坏暮谩薄?shí)際上，注釋最多也就是一個(gè)必須的惡，也編程語(yǔ)言足夠有表達(dá)力，或者我們長(zhǎng)于用這些語(yǔ)言來(lái)表達(dá)意圖，就不那么需要注釋——也許根本不需要。注釋什么也比不上放置良好的注釋來(lái)的有用。什么也比不注釋一、注釋會(huì)撒謊。a、這個(gè)比較令人費(fèi)解。但是它真實(shí)的存在于我們的系統(tǒng)中，并且是大量的存在。原因很簡(jiǎn)單，程序員不能堅(jiān)持維持注釋?zhuān)绦虼嬖诘臅r(shí)間越久，注釋的可信度、可讀程序就很低。作者認(rèn)為，程序員雖然有保持注釋精讀的責(zé)任，但是更應(yīng)該做的是整理代碼，減少注釋?zhuān)⑨屵^(guò)多往往是一種程序“腐化的壞味道”。b、注釋不能美化糟糕的代碼。注釋一、注釋會(huì)撒謊。注釋二、好的注釋a、不可省略的涉及到法律的信息b、提供信息的注釋:如果找不到好名字，則用注釋提供信息是好的做法c、對(duì)意圖進(jìn)行解釋:對(duì)某些可以選擇的實(shí)現(xiàn)決定進(jìn)行解釋d、闡釋:將一些晦澀難明的參數(shù)或者返回值的意義編譯為更加可讀的形式e、警示:這里指的是一些特定行為的代碼的注釋。比如某個(gè)測(cè)試可能會(huì)運(yùn)行很長(zhǎng)時(shí)間之類(lèi)的注釋。f、TODO注釋:未完成的列表。完成后要?jiǎng)h除掉。g、放大:放大、明示某些特殊用法的合理性。注釋二、好的注釋注釋三、壞的注釋a、喃喃自語(yǔ)

這種情況大量存在，屬于程序員的只說(shuō)自話(huà)，基本是垃圾代碼的借口或者錯(cuò)誤決策的修正。b、多余的注釋

大量存在，沒(méi)有什么意義的廢話(huà)注釋。c、誤導(dǎo)性注釋

不夠精確或者干脆寫(xiě)錯(cuò)了d、循規(guī)試注釋

指的是應(yīng)文檔化工具的需求就添加的本來(lái)不需要注釋的注釋。注釋三、壞的注釋注釋e、日志試注釋

指的是本代碼文件的修改歷史類(lèi)，將每天的修改記錄寫(xiě)上，這完全沒(méi)有必要，可以被現(xiàn)代源碼管理工具取代。它影響了代碼閱讀。f、可怕的廢話(huà)注釋g、能用函數(shù)或者變量的時(shí)候就不用注釋h、位域標(biāo)記

這類(lèi)注釋用于標(biāo)記一個(gè)特別的位置。這種用法應(yīng)該在特定的情況下使用，但是多數(shù)屬于不必要的濫用。i、括號(hào)后的注釋

這里指的是代碼太長(zhǎng)了，在}后添加注釋表示×××代碼段結(jié)束。這類(lèi)注釋一般是程序需要整理的標(biāo)志。注釋e、日志試注釋注釋j、歸屬于署名

現(xiàn)在源碼管理可以取代，基本不需要了。k、注釋掉的代碼L、HTML注釋

令人討厭。m、非本地信息n、信息過(guò)多o、不明顯的聯(lián)系注釋j、歸屬于署名類(lèi)一、類(lèi)的組織

公共靜態(tài)常量、私有靜態(tài)變量、私有實(shí)體變量、公共方法、私有工具函數(shù)。類(lèi)一、類(lèi)的組織類(lèi)二、類(lèi)應(yīng)該短小

對(duì)于函數(shù)，我們通過(guò)計(jì)算代碼行數(shù)衡量大小。對(duì)于類(lèi)，我們采用不同的衡量方式，計(jì)算權(quán)責(zé)。

權(quán)責(zé)同職責(zé)，也同變化的原因。

1、類(lèi)應(yīng)該符合單一權(quán)責(zé)原則 2、類(lèi)應(yīng)該內(nèi)聚 3、保持內(nèi)聚會(huì)得到需要短小的類(lèi)

關(guān)于類(lèi)的組織這個(gè)話(huà)題比較大，比較原則性。注意理解不同設(shè)計(jì)原則之間的因果依賴(lài)關(guān)系。類(lèi)二、類(lèi)應(yīng)該短小ThankYou!ThankYou!

讀書(shū)交流會(huì)

多讀書(shū)

好讀書(shū)

讀好書(shū) 讀書(shū)交流會(huì)

多讀書(shū)

好讀書(shū)

讀好書(shū)舉頭望明月低頭敲代碼滿(mǎn)園春色關(guān)不住一串代碼飄出來(lái)夜闌臥聽(tīng)風(fēng)雨聲做夢(mèng)還在敲代碼洛陽(yáng)親友如相問(wèn)就說(shuō)我在敲代碼風(fēng)蕭蕭兮易水寒壯士要去敲代碼松下問(wèn)童子言師敲代碼白發(fā)三千丈Bug改不完垂死病中驚坐起今天還沒(méi)敲代碼在天愿做比翼鳥(niǎo)在地愿意敲代碼但愿人長(zhǎng)久天天敲代碼獻(xiàn)給廣大不辭辛勞的程序員們舉頭望明月獻(xiàn)給廣大不辭辛勞的程序員們閱讀本書(shū)有兩種原因第一，你是個(gè)程序員第二，你想成為更好的程序員閱讀本書(shū)有兩種原因主要內(nèi)容混亂代碼的代價(jià)整潔代碼藝術(shù)、什么是整潔代碼如何編寫(xiě)整潔代碼主要內(nèi)容混亂代碼的代價(jià)混亂代碼的代價(jià)YourTextHereYourTextHere一、要有代碼

有人說(shuō)過(guò)我們正在臨近代碼的終結(jié)點(diǎn)?？齑a就會(huì)自動(dòng)產(chǎn)生出來(lái)不需要再人工編寫(xiě)。程序員完全沒(méi)用了因?yàn)樯虅?wù)人士可以從規(guī)約直接生成程序。

代碼呈現(xiàn)了需求的細(xì)節(jié)?；靵y代碼的代價(jià)YourTextHereYourText混亂代碼的代價(jià)二、糟糕代碼

你是否曾為糟糕的代碼所深深困擾？如果你是位有點(diǎn)兒經(jīng)驗(yàn)的程序員，定然多次遇到過(guò)這類(lèi)困境。我們有專(zhuān)用來(lái)形容這事的詞：沼澤。我們趟過(guò)代碼的水域。我們穿過(guò)灌木密布、瀑布暗藏的沼澤地。我們拼命想找到出路，期望有點(diǎn)什么線(xiàn)索能啟發(fā)我們到底發(fā)生了什么事，但目光所及，只是越來(lái)越多死氣沉沉的代碼?；靵y代碼的代價(jià)二、糟糕代碼混亂代碼的代價(jià)隨著混亂的增加，團(tuán)隊(duì)生產(chǎn)力也持續(xù)下降趨向于零。當(dāng)生產(chǎn)力下降時(shí)，管理層就只有一件事可做了，增加更多人手到項(xiàng)目中，期望提升生產(chǎn)力。可是新人并不熟悉系統(tǒng)的設(shè)計(jì)。他們搞不清楚什么樣的修改符合設(shè)計(jì)意圖，什么樣的修改違背設(shè)計(jì)意圖。而且，他們以及團(tuán)隊(duì)中的其他人都背負(fù)著提升生產(chǎn)力的可怕壓力。于是，他們制造更多的混亂，驅(qū)動(dòng)生產(chǎn)力向零那端不斷下降?；靵y代碼的代價(jià)隨著混亂的增加，團(tuán)隊(duì)生產(chǎn)力也持續(xù)下混亂代碼的代價(jià)將需求明確到機(jī)器可以執(zhí)行的程度，就是編程要做的事，這種規(guī)約就是代碼。糟糕的代碼可能毀掉一家公司。混亂代碼的代價(jià)是驅(qū)動(dòng)生產(chǎn)力不斷趨向零。整潔不僅與效率有關(guān)，而且關(guān)于企業(yè)的生存。

什么樣的代碼是整潔代碼？混亂代碼的代價(jià)將需求明確到機(jī)器可以執(zhí)行的程度，就是編程要做的整潔代碼代碼邏輯應(yīng)當(dāng)直截了當(dāng)，叫缺陷難以隱藏，盡量減少依賴(lài)關(guān)系，使之便于維護(hù)，依據(jù)某種分層戰(zhàn)略完善錯(cuò)誤處理代碼，性能調(diào)至最優(yōu)，省得引誘別人做沒(méi)規(guī)矩的優(yōu)。整潔的代碼簡(jiǎn)單直接。整潔的代碼如同優(yōu)美的散文。整潔的代碼從不隱藏設(shè)計(jì)者的意圖，充滿(mǎn)了干凈利落的抽象和直截了當(dāng)?shù)目刂普Z(yǔ)句。果斷決絕。代碼應(yīng)當(dāng)講述事實(shí)不引人猜測(cè)。它只該包含必需之物。它應(yīng)當(dāng)有單元測(cè)試和驗(yàn)收測(cè)試。它使用有意義的命名。它只提供一種而非多種做一件事的途徑。它只有盡量少的依賴(lài)關(guān)系而且要明確地定義和提供清晰、盡量少的API。代碼應(yīng)通過(guò)其字面表達(dá)含義因?yàn)椴煌恼Z(yǔ)言導(dǎo)致并非所有必需信息均可通過(guò)代碼自身清晰表達(dá)。整潔代碼代碼邏輯應(yīng)當(dāng)直截了當(dāng)，叫缺陷難以隱藏，盡量減少依賴(lài)關(guān)整潔代碼沒(méi)有測(cè)試的代碼不干凈。不管它有多優(yōu)雅不管有多可讀、多易理解微乎測(cè)試其不潔亦可知也。整潔的代碼總是看起來(lái)像是某位特別在意它的人寫(xiě)的。幾乎沒(méi)有改進(jìn)的余地。代碼作者什么都想到了如果你企圖改進(jìn)它總會(huì)回到原點(diǎn)。能通過(guò)所有測(cè)試；沒(méi)有重復(fù)代碼；體現(xiàn)系統(tǒng)中的全部設(shè)計(jì)理念；包括盡量少的實(shí)體，比如類(lèi)、方法、函數(shù)等。整潔代碼沒(méi)有測(cè)試的代碼不干凈。不管它有多優(yōu)雅不管有多可讀、如何編寫(xiě)整潔代碼命名函數(shù)注釋類(lèi)如何編寫(xiě)整潔代碼命名命名一、要“名副其實(shí)” a、這件事情要嚴(yán)肅對(duì)待。

在起一個(gè)表意的名字上花時(shí)間是值得的，優(yōu)秀程序員從細(xì)節(jié)做起。 b、如果名稱(chēng)需要注釋來(lái)補(bǔ)充，那就不是“名副其實(shí)”。 Demo：intd;//消逝的時(shí)間，以天計(jì)算

應(yīng)該使用指明計(jì)量對(duì)象和計(jì)量單位的名稱(chēng)。 IntelapsedTimeInDays; IntdaysSinceCreation; IntdaysSinceModificatin; IntfileAgeInDays’命名一、要“名副其實(shí)”命名c、問(wèn)題不在于代碼的簡(jiǎn)潔度，而在于代碼的“模糊度”。

這里的意思是簡(jiǎn)短的代碼，如果不能表達(dá)含義，也是不能做到“名副其實(shí)”。 Demo: Java:pulicList<int[]>getThem(){ List<int[]>list1=newArrayList<int[]>(); For(int[]x:theList) If(x[0]==4) list1.add(x); returnlist1; }

這里的代碼夠簡(jiǎn)單了，但是沒(méi)人知道theList是什么東西、theList[0]的意思是什么、d、是什么意義、以及返回list1該怎么用。

這就是作者所說(shuō)的“模糊度”，因?yàn)橐饬x比較模糊，所以這些代碼也不“名副其實(shí)”。那么怎么呢？應(yīng)該根據(jù)這段代碼的意圖來(lái)修改這里的函數(shù)名，變量名，值的含義（用常量）。命名c、問(wèn)題不在于代碼的簡(jiǎn)潔度，而在于代碼的“模糊度”。命名二、命名要避免誤導(dǎo)

程序員必須避免留下掩藏代碼本意的錯(cuò)誤線(xiàn)索。 Demo:accountList這個(gè)名字就不太好，因?yàn)閘ist這詞在java中是一個(gè)類(lèi)型，如果這個(gè)名字表達(dá)的類(lèi)型或者含義不是list就不應(yīng)該這樣命名。命名二、命名要避免誤導(dǎo)命名三、做有意義的區(qū)分

a、不要用數(shù)字命名， Demo:a1,a2,a3。b、話(huà)是另一種沒(méi)有意義的區(qū)分， Demo：如有有一個(gè)類(lèi)叫Product類(lèi)，那么ProductInfo與ProctductData就是沒(méi)有意義的區(qū)分，因?yàn)樗鼈兒x幾乎一樣。c、使用讀得出來(lái)的名字d、使用搜索得出來(lái)的名字e、接口和實(shí)現(xiàn) Demo:IShapeFactory和SharpFactory之間，選擇后者作為接口名命名三、做有意義的區(qū)分函數(shù)

函數(shù)的第一條規(guī)則是要短小，第二條規(guī)則還是要短小。40年的經(jīng)驗(yàn)告訴作者，函數(shù)就是要短小。20行封頂最佳。每個(gè)函數(shù)都一目了然，每個(gè)函數(shù)都做一件事。而且每個(gè)函數(shù)都依序把你帶到下一個(gè)函數(shù)，這就是函數(shù)應(yīng)該達(dá)到的短小程度。函數(shù)函數(shù)的第一條規(guī)則是要短小，第二條規(guī)則還是要短小。40年函數(shù)二、只做一件事

函數(shù)所做的事情都在一個(gè)抽象層級(jí)，叫“只做一件事”。如果各個(gè)層級(jí)抽象混雜在一起，顯然就做了不止一件事了函數(shù)二、只做一件事函數(shù)三、每個(gè)函數(shù)一個(gè)抽象層級(jí)函數(shù)中混雜不同的抽象層級(jí)，往往讓人迷惑。讀者無(wú)法判斷哪些是基礎(chǔ)概念哪些是細(xì)節(jié)。讀者無(wú)法提綱挈領(lǐng)的代價(jià)是，它無(wú)法快速學(xué)習(xí)，快速理解。從而為更多的bug埋下隱患。函數(shù)三、每個(gè)函數(shù)一個(gè)抽象層級(jí)函數(shù)四、使用描述性名稱(chēng)Demo:testtableHtmlSetupTeardownIncluder.render。如果長(zhǎng)一點(diǎn)的名稱(chēng)可以更加清晰，不要猶豫，用清晰的吧。函數(shù)四、使用描述性名稱(chēng)函數(shù)五、函數(shù)參數(shù)最好是0，其次是1，再次是2，避免3個(gè)及以上的參數(shù)個(gè)數(shù)。參數(shù)過(guò)多會(huì)使得客戶(hù)程序員上手的代價(jià)加大，優(yōu)秀代碼的可能性降低。函數(shù)五、函數(shù)參數(shù)函數(shù)五、抽離Try/Catch代碼將try/catch代碼隔離出來(lái)，避免影響主程序邏輯。Demo:Try{ DeletePage(page);//DeletePage是一個(gè)方法}Catch(Exceptione){LogError(e);//LogError是一個(gè)方法}

錯(cuò)誤處理就是一件事。函數(shù)五、抽離Try/Catch代碼注釋什么也比不上放置良好的注釋來(lái)的有用。什么也比不上亂七八糟的注釋更有本事搞亂一個(gè)模塊。什么也不會(huì)比陳舊、提供錯(cuò)誤信息的注釋更有破壞性。注釋并不像辛德勒的名單。他們并不“純?nèi)坏暮谩?。?shí)際上，注釋最多也就是一個(gè)必須的惡，也編程語(yǔ)言足夠有表達(dá)力，或者我們長(zhǎng)于用這些語(yǔ)言來(lái)表達(dá)意圖，就不那么需要注釋——也許根本不需要。注釋什么也比不上放置良好的注釋來(lái)的有用。什么也比不注釋一、注釋會(huì)撒謊。a、這個(gè)比較令人費(fèi)解。但是它真實(shí)的存在于我們的系統(tǒng)中，并且是大量的存在。原因很簡(jiǎn)單，程序員不能堅(jiān)持維持注釋?zhuān)绦虼嬖诘臅r(shí)間越久，注釋的可信度、可讀程序就很低。作者認(rèn)為，程序員雖然有保持注釋精讀的責(zé)任，但是更應(yīng)該做的是整理代碼，減少注釋?zhuān)⑨屵^(guò)多往往是一種程序“腐化的壞味道”。b、注釋不能美化糟糕的代碼。注釋一、注釋會(huì)撒謊。注釋二、好的注釋a、不可省略的涉及到法律的信息b、提供信息的注釋:如果找不到好名字，則用注釋提