0
  • 聊天消息
  • 系統(tǒng)消息
  • 評論與回復(fù)
登錄后你可以
  • 下載海量資料
  • 學(xué)習(xí)在線課程
  • 觀看技術(shù)視頻
  • 寫文章/發(fā)帖/加入社區(qū)
會員中心
創(chuàng)作中心

完善資料讓更多小伙伴認(rèn)識你,還能領(lǐng)取20積分哦,立即完善>

3天內(nèi)不再提示

為什么要寫糟糕的代碼?什么是整潔的代碼?

汽車ECU開發(fā) ? 來源:稀土掘金 ? 作者:unebrise ? 2022-11-21 10:58 ? 次閱讀

寫在前面

這個文章本來沒打算寫,直到經(jīng)歷了幾次代碼評審會議之后,我意識到自己編碼方式還不成系統(tǒng),仍然需要進行系統(tǒng)化的學(xué)習(xí),掌握前輩們總結(jié)出的最適用的規(guī)律無疑是一種好的方式。恰好很早之前就收藏了這本代碼整潔之道,便決定趁著閑暇之際閱讀總結(jié)一下,如果想系統(tǒng)學(xué)習(xí)的話建議還是讀書,本文檔只是作為自己的記錄用。

一個人的職業(yè)素養(yǎng)體現(xiàn)在解決問題的方式、步驟以及反思的程度,而不在于這個問題本身的難度。思考一個問題:一個技術(shù)人員要具備哪些素質(zhì)可以被認(rèn)為是專業(yè)人員呢?如果還不具備需要如何改變才能被視為專業(yè)人士呢?

整潔代碼

一、為什么要寫糟糕的代碼?

每個人都有自己的原因,相信很多人都會想著等有時間的話再進行代碼優(yōu)化,但是要記住一句話:稍后等于永不。

二、混亂代碼的代價?

后續(xù)難以維護和修改,生產(chǎn)力和時間呈現(xiàn)負(fù)相關(guān)。

三、什么是整潔的代碼?

整潔的代碼只做好一件事:每個類、每個函數(shù)、每個模塊都專注于一事,完全不受四周細(xì)節(jié)的干擾和污染。

更全面的概括是:減少重復(fù)代碼、提高表達(dá)力、提早構(gòu)建簡單抽象。

更具體的實現(xiàn):請接著往下看吧!

更好的變量命名

一、見名知意

二、抽象工廠:接口不要命名為IShapeFactory,前導(dǎo)字母對于用戶來說其實是干擾,用戶只需要知道那是個抽象工廠,建議使用CShapeFactory或許體驗更好

三、類名要用名詞,方法要用動詞,詞性相近的get、fetch這種詞不應(yīng)出現(xiàn)在一起,可以添加后綴getNumber、fetchData實現(xiàn)相同的效果

四、別害怕長名字:使用描述性的名稱,哪怕比較長也比短而令人費解的名稱好

更好的函數(shù)

一、函數(shù)的結(jié)構(gòu)本質(zhì)上要短小、再短小,以不容納if/else if/else嵌套結(jié)構(gòu)為目標(biāo)

二、只做一件事:正如前面所說,函數(shù)只做好一件事就足夠了,標(biāo)志就是“看是否還能拆出一個函數(shù),該函數(shù)不僅只是單純地重新詮釋其實現(xiàn)”

三、每個函數(shù)一個抽象層級:代碼一般是“自頂向下”的閱讀順序,每個函數(shù)后面跟著的應(yīng)該是下一抽象層級的函數(shù)

[抽象層級:getHtml函數(shù)位于較高抽象層,pagePathName = pathParser.render(pagePath)位于中間抽象層,.append(" ")則位于較低抽象層]

四、switch語句:天生就需要做N件事,但是可以將其放置在較低抽象層級,但是當(dāng)出現(xiàn)新的類型時會違反“單一權(quán)責(zé)原則、開放閉合原則”,此時最好創(chuàng)建多態(tài)對象

//原文中:對于每個case分支進行單獨處理,添加新類型不必修改原來的代碼增加新的處理類即可
functiongetName(name){
switch(name){
case'ming':
returnnewClassMing(name);
case'hu':
returnnewClassHu(name);
case'uzi':
returnnewClassUzi(name);
default:
thrownewClassCommon(name);
}
}

//我更喜歡用另一種方法:修改只需要在對象里修改即可,且提高了函數(shù)的簡潔性
constnameCollectionUtils={
 ming:newClassMing('ming');
hu:newClassHu('hu');
uzi:newClassUzi('uzi');
}
functiongetName(name){
returnnameCollectionUtils.hasOwn(name)?nameCollectionUtils[name]:newClassCommon(name)
}

五、函數(shù)參數(shù)最多不多于兩個:包括輸入?yún)?shù)和輸出參數(shù)

六、無副作用:函數(shù)內(nèi)部不要做出未能預(yù)期的改動,不要對外部產(chǎn)生影響

七、使用異常替代返回錯誤碼:使用try...catch替代多層級的if嵌套,永遠(yuǎn)走在主路上,不要過多考慮邊界,這樣可以讓你一直保持思維連貫

八、錯誤處理單獨抽出:這一條我認(rèn)為可以視情況而定,畢竟抽出僅僅是為了美觀

九、別重復(fù):多個函數(shù)使用的相同邏輯的代碼一定要抽出,可以參考面向?qū)ο蟮幕?,前端開發(fā)中的面向組件編程、面向模塊編程也是這種思想

注釋&格式

每個人有每個人的習(xí)慣,采取一些通用準(zhǔn)則即可,畢竟如何太過離譜在公司是會挨打的~

錯誤處理

也沒有什么固定的章程,最好采取try...catch優(yōu)先的原則

邊界

總結(jié)而言,使用自己可以控制的代碼

單元測試

現(xiàn)在的互聯(lián)網(wǎng)企業(yè)絕大多數(shù)都是敏捷式開發(fā),很少有能遵守測試驅(qū)動原則的公司,而且為了保證進度很少會有技術(shù)團隊會去要求單元測試,所以這一條仁者見仁吧,個人認(rèn)為這一項的實際實現(xiàn)只能是一個比較美好的愿景。

一、類的組織:按照下面的順序,不要暴露出內(nèi)部屬性,利用方法達(dá)到同樣的目的

classDemoOrganization{
staticsname='sname'
privatepname='pname'
private_pname='_pname'
protectedtname='tname'

publicgetPublicName(){
returnthis.pname
}
private_getPrivateName(){
returnthis._pname
}
}

二、單一權(quán)責(zé)原則(SPR):類或模塊應(yīng)有且只有一條加以修改的理由,實現(xiàn)了這個原則的類更易得到復(fù)用

三、保持內(nèi)聚性:類中定義的變量應(yīng)被盡可能多的方法使用到,如果不能滿足的話就把使用到變量的函數(shù)拆分成小類

四、開放封閉原則(OCP):類應(yīng)當(dāng)對擴展開放,對修改封閉,通過子類化手段可以實現(xiàn)新功能的添加的同時不觸及其他類

五、依賴倒置原則(DIP):類應(yīng)當(dāng)依賴于抽象而不是依賴于具體細(xì)節(jié)

六、解耦:不同方法和模塊間不要互相產(chǎn)生影響,即“分而治之”、“化整為零”

系統(tǒng)

一、構(gòu)造和使用分開:構(gòu)造的細(xì)節(jié)應(yīng)隔離與應(yīng)用程序代碼之外,使用者只能獲取構(gòu)造者想讓使用者獲得的東西

二、設(shè)計時要能滿足從簡單到復(fù)雜的更新迭代

迭進

總結(jié)上述,只要遵守以下原則,就可以得到一個具有良好設(shè)計的可迭進的程序:

運行所有測試

不可重復(fù)

表達(dá)了程序員的意圖

盡可能減少類和方法的數(shù)量

以上規(guī)則按重要程度排列

并發(fā)編程

首先要了解“線程”這個概念:CPU調(diào)度的最小單位,區(qū)別于“進程”是資源分配的最小單位。區(qū)別見下方表格:

分類 數(shù)據(jù)共享 消耗資源 是否影響兄弟程序 最大可擴展維度 是否有鎖
進程 多機
線程 簡單 可能影響所在進程 多核

如果說對象是過程的抽象,那么線程是調(diào)度的抽象

前端使用的js語言是瀏覽器腳本語言,最主要的用途是和用戶互動和操作DOM,這決定了js只能是單線程否則會產(chǎn)生復(fù)雜的同步問題,但是js仍然可以模擬并發(fā)執(zhí)行,具體實現(xiàn)自行查詢相關(guān)資料

當(dāng)前還沒學(xué)習(xí)到并發(fā)編程的語言,以后碰到再補充學(xué)習(xí)

重構(gòu)

這個模塊我認(rèn)為是最重要的模塊,甚至比怎么去編寫新的程序更重要,因為一個公司的沉積項目的數(shù)量是巨大的,很可能會對其中幾個甚至更多進行重構(gòu)(還是因為之前代碼寫的太爛無法維護),所以重構(gòu)中需要注意的點也要有一個清晰的認(rèn)知。

只需要遵守一條原則:簽入的代碼比簽出的更整潔。

寫在最后

以上是我從前端角度總結(jié)的從這本書中得到的一些收獲,但是每個人都會有每個人自己的理解,所以還是推薦自己去讀一遍這本書,不需要多精細(xì)只要熟悉一下這些概念提出來的場景,相信會有更大的收獲。






審核編輯:劉清

聲明:本文內(nèi)容及配圖由入駐作者撰寫或者入駐合作網(wǎng)站授權(quán)轉(zhuǎn)載。文章觀點僅代表作者本人,不代表電子發(fā)燒友網(wǎng)立場。文章及其配圖僅供工程師學(xué)習(xí)之用,如有內(nèi)容侵權(quán)或者其他違規(guī)問題,請聯(lián)系本站處理。 舉報投訴
  • SPR
    SPR
    +關(guān)注

    關(guān)注

    0

    文章

    20

    瀏覽量

    11465
  • DIP
    DIP
    +關(guān)注

    關(guān)注

    0

    文章

    239

    瀏覽量

    30029
  • OCP
    OCP
    +關(guān)注

    關(guān)注

    0

    文章

    76

    瀏覽量

    16336
  • DOM
    DOM
    +關(guān)注

    關(guān)注

    0

    文章

    16

    瀏覽量

    9557

原文標(biāo)題:常說的代碼整潔到底是什么?

文章出處:【微信號:eng2mot,微信公眾號:汽車ECU開發(fā)】歡迎添加關(guān)注!文章轉(zhuǎn)載請注明出處。

收藏 人收藏

    評論

    相關(guān)推薦

    代碼整潔之道-大師眼中的整潔代碼是什么樣

    模糊,帶著這個問題,本人讀完了世界軟件開發(fā)大師馬丁的《代碼整潔之道》這本書,來了解下大師眼中的整潔代碼畫像是什么樣的,相信能給你帶來不一樣的理解和感悟。 關(guān)于
    的頭像 發(fā)表于 09-09 16:30 ?215次閱讀
    <b class='flag-5'>代碼</b><b class='flag-5'>整潔</b>之道-大師眼中的<b class='flag-5'>整潔</b><b class='flag-5'>代碼</b>是什么樣

    軟件設(shè)計哲學(xué):新“代碼整潔之道”

    工作三年以來一直對寫出設(shè)計優(yōu)雅且可讀性較好的代碼抱有執(zhí)念,最初接觸到的關(guān)于代碼整潔和軟件設(shè)計的書是《代碼整潔之道》,這本書大概在我入職半年時
    的頭像 發(fā)表于 07-22 12:18 ?185次閱讀
    軟件設(shè)計哲學(xué):新“<b class='flag-5'>代碼</b><b class='flag-5'>整潔</b>之道”

    國內(nèi)低代碼平臺推薦--萬界星空科技低代碼平臺

    代碼平臺是一種應(yīng)用程序,它為編程提供圖形用戶界面,從而以極快的速度開發(fā)代碼,減少傳統(tǒng)編程工作。 這些工具有助于快速開發(fā)代碼,最大限度地減少手工編碼的工作量。這些平臺不僅有助于編碼,還有助于快速設(shè)置和部署。
    的頭像 發(fā)表于 07-18 15:39 ?217次閱讀
    國內(nèi)低<b class='flag-5'>代碼</b>平臺推薦--萬界星空科技低<b class='flag-5'>代碼</b>平臺

    該如何提高代碼容錯率、降低代碼耦合度?

    提高RT-Thread代碼的容錯率和降低耦合度是確保代碼質(zhì)量和可維護性的關(guān)鍵,下面列舉了幾種在編寫代碼時,提高代碼容錯率和降低耦合度的思路。讓我們一起來看看吧~一、提高
    的頭像 發(fā)表于 06-26 08:10 ?475次閱讀
    該如何提高<b class='flag-5'>代碼</b>容錯率、降低<b class='flag-5'>代碼</b>耦合度?

    藍(lán)牙遙控代碼及使用

    藍(lán)牙遙控代碼及使用
    的頭像 發(fā)表于 05-15 10:15 ?548次閱讀

    如何提升代碼質(zhì)量與效率的秘訣

    提高編程能力其實沒有捷徑,最佳方式就是多寫代碼。 不過,除了寫大量代碼,提升編程能力還需要大量閱讀別人寫的代碼。
    的頭像 發(fā)表于 04-28 14:53 ?325次閱讀
    如何提升<b class='flag-5'>代碼</b>質(zhì)量與效率的秘訣

    請問STM32CubeIDE如何查看代碼總行數(shù)?

    近期填寫資料,需要寫當(dāng)前項目源代碼總行數(shù),使用的STM32CubeIDE開發(fā)的,想請教一下,這個IDE怎么看代碼的總行數(shù)?
    發(fā)表于 03-28 07:07

    g代碼和m代碼表示什么功能

    G代碼和M代碼是數(shù)控機床程序中常用的兩種指令代碼,用于控制數(shù)控機床的工作動作和運動方式。 G代碼是指控制機床工作動作的指令代碼,它是一種簡單
    的頭像 發(fā)表于 02-14 15:49 ?3610次閱讀

    2023中國企業(yè)低代碼/無代碼產(chǎn)品應(yīng)用與實踐研究

    并且AI對低代碼/無代碼行業(yè)的影響也逐步增大,AI代碼和低代碼/無代碼雖然技術(shù)路徑大相徑庭,但是在實現(xiàn)開發(fā)的高效、快速敏捷這一核心目的上殊途
    的頭像 發(fā)表于 12-08 16:08 ?613次閱讀
    2023中國企業(yè)低<b class='flag-5'>代碼</b>/無<b class='flag-5'>代碼</b>產(chǎn)品應(yīng)用與實踐研究

    安秉信息源代碼圖紙防泄密方案,電路圖紙,源代碼文件

    安秉信息源代碼圖紙防泄密方案,電路圖紙,源代碼文件
    發(fā)表于 12-01 16:56 ?0次下載

    python軟件怎么運行代碼

    Python是一種高級編程語言,它被廣泛用于開發(fā)各種類型的應(yīng)用程序,從簡單的腳本到復(fù)雜的網(wǎng)絡(luò)應(yīng)用和機器學(xué)習(xí)模型。要運行Python代碼,您需要一個Python解釋器,它可以將您的代碼翻譯成計算機可以
    的頭像 發(fā)表于 11-28 16:02 ?817次閱讀

    python怎樣運行代碼

    討論Python代碼的運行方式,包括解釋器、交互式環(huán)境和命令行。 Python代碼可以通過兩種主要的方式運行:解釋執(zhí)行和編譯執(zhí)行。解釋執(zhí)行是指將源代碼逐行解釋為機器代碼并執(zhí)行,而編譯執(zhí)
    的頭像 發(fā)表于 11-22 10:31 ?1084次閱讀

    devc怎么注釋掉一段代碼

    在DevC中,要注釋掉一段代碼,你可以使用注釋符號來標(biāo)記這段代碼。注釋符號的作用是告訴編譯器不要編譯這些代碼,而是將其視為注釋,這樣可以方便開發(fā)人員在代碼中添加解釋、說明或者臨時禁用某
    的頭像 發(fā)表于 11-22 10:23 ?2103次閱讀

    代碼即注釋,注釋即代碼的概念是如何形成的

    "代碼即注釋,注釋即代碼"這個概念是如何形成的呢?記得之前看一些討論,程序員應(yīng)該如何寫代碼的注釋,大家的意見很多,不過我只對兩句話記憶非常深刻:
    的頭像 發(fā)表于 11-18 16:52 ?670次閱讀
    <b class='flag-5'>代碼</b>即注釋,注釋即<b class='flag-5'>代碼</b>的概念是如何形成的

    linux虛擬機怎么運行代碼

    運行代碼是Linux虛擬機中的常見操作,本文將詳細(xì)介紹如何運行代碼。 首先,要運行代碼,你需要先安裝好Linux虛擬機,并確保能夠順利運行。接下來,你需要打開虛擬機,并登錄到系統(tǒng)中。 一旦你登錄
    的頭像 發(fā)表于 11-17 10:12 ?4477次閱讀