代碼整潔之道學(xué)習(xí)筆記

內(nèi)容摘抄于【代碼整潔之道】一書

一鞋吉、為什么

軟件質(zhì)量與代碼整潔度成正比;

延長(zhǎng)產(chǎn)品生命周期励烦,可持續(xù)化開發(fā)與交付谓着;

不整潔的代碼,團(tuán)隊(duì)的生產(chǎn)力會(huì)持續(xù)下降坛掠;

便于維護(hù)赊锚,減少技術(shù)債;

二屉栓、什么算是整潔的代碼

cleancode.jpg

三舷蒲、如何寫出整潔的代碼

3.1 有意義的命名

  • 名副其實(shí)
  • 避免誤導(dǎo)
  • 做有意義的區(qū)分
  • 使用可讀得出來的名稱
  • 使用可搜索的名稱
  • 避免使用編碼
  • 避免思維映射
  • 類名
  • 方法名
  • 上下文中每個(gè)概念對(duì)應(yīng)一個(gè)詞
  • 別用雙關(guān)語
  • 使用解決方案領(lǐng)域名
  • 使用源自所涉問題領(lǐng)域的名稱
  • 添加有意義的語境
  • 不要添加沒有意義的語境

3.2 函數(shù)

  • 短小
  • 只做一件事(SRP)
  • 每個(gè)函數(shù)一個(gè)抽象層級(jí)
  • Switch語句
  • 使用描述性的名稱
  • 函數(shù)參數(shù)不要大于3個(gè)
  • 無副作用 別重復(fù)自己
  • 分隔指令與詢問

3.3 注釋

注釋不能美化糟糕的代碼

  • 好的注釋: 法律信息 對(duì)業(yè)務(wù)的注釋 警示 TODO注釋 公共API的注釋
  • 壞的注釋:多余的 誤導(dǎo)性的 日志式的 廢話注釋 位置標(biāo)記 歸屬與署名 注釋掉的代碼 信息過多

3.4 格式

  • 垂直格式:垂直方向上的區(qū)隔 垂直方向上的靠近 垂直方向上的距離 垂直方向上的順序
  • 水平格式:水平方向上的區(qū)隔 水平對(duì)其 縮進(jìn) 空范圍

3.5 對(duì)象與數(shù)據(jù)結(jié)構(gòu)

  • 數(shù)據(jù)抽象
  • 數(shù)據(jù)、對(duì)象的反對(duì)稱性
    對(duì)象把數(shù)據(jù)隱藏于抽象之后友多,暴露操作數(shù)據(jù)的函數(shù)牲平。(暴露行為)
    數(shù)據(jù)結(jié)構(gòu)暴露其數(shù)據(jù),沒有提供有意義的函數(shù)域滥。(暴露數(shù)據(jù))
  • 得墨忒耳律——火車失事纵柿、混雜蜈抓、隱藏結(jié)構(gòu)
  • 數(shù)據(jù)傳送對(duì)象(java中的DTO)

3.6 錯(cuò)誤處理

  • 使用異常處理函數(shù)而非返回碼
  • 不要產(chǎn)生異常鏈
  • 異常信息要充分有用
  • 不要返回null
  • 不要傳遞null

3.7 邊界

  • 了解使用的第三方程序(問題、未開放的功能等)
  • 針對(duì)引入的第三方程序昂儒,未能滿足我們現(xiàn)有需求沟使,可以自定義實(shí)現(xiàn),等待第三方的完善
  • 不要深入去修改引入的第三方程序

3.8 逐步改進(jìn)

  • 代碼不止能工作渊跋,僅僅能工作的代碼就像一顆定時(shí)炸彈
  • 不要做滿足于僅僅能讓代碼工作的程序員
  • 整潔的代碼不是一次就能寫出來的腊嗡,是一個(gè)循序漸進(jìn)的過程

小結(jié):

  • KISS原則:KISS=Keep It Short and Simple.(盡量保持簡(jiǎn)單。)
  • SRP:Single Responsibility Principle.(單一職責(zé)原則拾酝。)
  • DRY原則:Don’t Repeat Yourself.(不要寫重復(fù)的代碼燕少。)
  • 健壯性,可讀性強(qiáng)
  • 把握時(shí)機(jī)蒿囤,敢于無情的重構(gòu)
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末棺亭,一起剝皮案震驚了整個(gè)濱河市,隨后出現(xiàn)的幾起案子蟋软,更是在濱河造成了極大的恐慌镶摘,老刑警劉巖,帶你破解...
    沈念sama閱讀 217,734評(píng)論 6 505
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件岳守,死亡現(xiàn)場(chǎng)離奇詭異凄敢,居然都是意外死亡,警方通過查閱死者的電腦和手機(jī)湿痢,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 92,931評(píng)論 3 394
  • 文/潘曉璐 我一進(jìn)店門涝缝,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人譬重,你說我怎么就攤上這事拒逮。” “怎么了臀规?”我有些...
    開封第一講書人閱讀 164,133評(píng)論 0 354
  • 文/不壞的土叔 我叫張陵滩援,是天一觀的道長(zhǎng)。 經(jīng)常有香客問我塔嬉,道長(zhǎng)玩徊,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 58,532評(píng)論 1 293
  • 正文 為了忘掉前任谨究,我火速辦了婚禮恩袱,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘胶哲。我一直安慰自己畔塔,他們只是感情好,可當(dāng)我...
    茶點(diǎn)故事閱讀 67,585評(píng)論 6 392
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著澈吨,像睡著了一般把敢。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上棚辽,一...
    開封第一講書人閱讀 51,462評(píng)論 1 302
  • 那天,我揣著相機(jī)與錄音冰肴,去河邊找鬼屈藐。 笑死,一個(gè)胖子當(dāng)著我的面吹牛熙尉,可吹牛的內(nèi)容都是我干的联逻。 我是一名探鬼主播,決...
    沈念sama閱讀 40,262評(píng)論 3 418
  • 文/蒼蘭香墨 我猛地睜開眼检痰,長(zhǎng)吁一口氣:“原來是場(chǎng)噩夢(mèng)啊……” “哼包归!你這毒婦竟也來了?” 一聲冷哼從身側(cè)響起铅歼,我...
    開封第一講書人閱讀 39,153評(píng)論 0 276
  • 序言:老撾萬榮一對(duì)情侶失蹤公壤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個(gè)月后椎椰,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體厦幅,經(jīng)...
    沈念sama閱讀 45,587評(píng)論 1 314
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 37,792評(píng)論 3 336
  • 正文 我和宋清朗相戀三年慨飘,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了确憨。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點(diǎn)故事閱讀 39,919評(píng)論 1 348
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡瓤的,死狀恐怖休弃,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情圈膏,我是刑警寧澤塔猾,帶...
    沈念sama閱讀 35,635評(píng)論 5 345
  • 正文 年R本政府宣布,位于F島的核電站稽坤,受9級(jí)特大地震影響桥帆,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜慎皱,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 41,237評(píng)論 3 329
  • 文/蒙蒙 一老虫、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧茫多,春花似錦祈匙、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,855評(píng)論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽跪帝。三九已至,卻和暖如春些阅,著一層夾襖步出監(jiān)牢的瞬間伞剑,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 32,983評(píng)論 1 269
  • 我被黑心中介騙來泰國(guó)打工市埋, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留黎泣,地道東北人。 一個(gè)月前我還...
    沈念sama閱讀 48,048評(píng)論 3 370
  • 正文 我出身青樓缤谎,卻偏偏與公主長(zhǎng)得像抒倚,于是被迫代替她去往敵國(guó)和親。 傳聞我的和親對(duì)象是個(gè)殘疾皇子坷澡,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 44,864評(píng)論 2 354

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

  • 代碼整潔之道讀書筆記 一托呕、有意義的命名 名副其實(shí) 表示產(chǎn)品A上線時(shí)間剩余天數(shù) 獲取水果訂單中所有的id為4的蘋果訂...
    王樂城愚人云端閱讀 721評(píng)論 0 0
  • 一、整潔代碼 A.混亂的代價(jià) 1.有些團(tuán)隊(duì)在項(xiàng)目初期進(jìn)展迅速频敛,但有那么一兩年的時(shí)間卻慢去蝸行项郊。對(duì)代碼的每次修改都影...
    ZyBlog閱讀 2,039評(píng)論 0 2
  • 代碼整潔之道 Clean Code 第一章 整潔代碼 代碼的重要性我們永遠(yuǎn)拋不掉代碼,因?yàn)榇a呈現(xiàn)了需求的細(xì)節(jié)斟赚。在...
    Pengzh1閱讀 1,216評(píng)論 0 1
  • “相對(duì)于任何宏偉景愿呆抑,對(duì)細(xì)節(jié)的關(guān)注甚至是更為關(guān)鍵的專業(yè)性基礎(chǔ)。首先汁展,開發(fā)者通過小型實(shí)踐獲得可用于大型實(shí)踐的技能和信...
    尋海閱讀 4,727評(píng)論 1 27
  • 目錄及筆記鏈接 序 丹麥諺語:小處誠(chéng)實(shí)非小事鹊碍。 建筑師路德維希:神在細(xì)節(jié)之中。 日本的 5S 哲學(xué): 整理(整理食绿、...
    小鐳Ra閱讀 1,496評(píng)論 3 3