主頁 > 軟體設計 > Design Patterns | 02 什么樣的代碼是好代碼

Design Patterns | 02 什么樣的代碼是好代碼

2020-09-13 08:44:52 軟體設計

目錄
  • 01 - 什么是好的代碼?
  • 02 - 評價代碼的標準有哪些
    • 2.1 可維護性(maintainability)
    • 2.2 可讀性(readability)
    • 2.3 可擴展性(extensibility)
    • 2.4 簡潔性(simplicity)
    • 2.5 可復用性(reusability)
    • 2.6 可測驗性(testability)
  • 03 - 本篇總結
    • 著作權宣告

01 - 什么是好的代碼?

對開發人員來說,辨別代碼的“好”和“爛”,是個非常重要的能力,這也是我們寫出好代碼的前提,

那什么是好的代碼,我們應該從哪些維度評判代碼質量的高低呢?

答案是:很難通過某(幾)個詞匯來全面地評價代碼質量,

“評價”這個詞本身就有很強的主觀性,每個人的標準都不盡一致,但不可否認的是,越有經驗的工程師,給出的評價也就越準確,

02 - 評價代碼的標準有哪些

2.1 可維護性(maintainability)

“維護”,就是修改 bug、修改老代碼、添加新代碼之類的作業,

  • “代碼易維護”,就是在不破壞原有代碼設計、不引入新 bug 的情況下,能夠快速修改或者添加代碼,
  • “代碼不易維護”,就是修改或者添加代碼時很可能引入新的 bug,并且需要花費很長的時間才能完成,

大多數專案中,維護代碼的時間要遠多于撰寫代碼的時間,所以代碼的可維護性非常重要,

影響代碼的可維護性的因素有很多,比如:

  • 代碼的分層是否清晰,模塊化是否良好,模塊間耦合性是否足夠低(要高內聚、低耦合);
  • 專案代碼量的多少,業務的復雜程度,使用到的技術的復雜程度;
  • 另外,各類程序檔案的撰寫、團隊成員的開發水平等因素也會影響代碼的可維護性,

2.2 可讀性(readability)

首先,代碼被閱讀的次數要遠遠超過被撰寫、修改的次數,讀不懂代碼,就很難安全地添加新功能、修復舊 bug,

代碼的可讀性,與代碼是否符合編碼規范、代碼的命名(包括類、函式、變數等)是否達意、注釋是否詳盡、函式是否長短合適、模塊劃分是否清晰等因素有關,

影響代碼的可維護性的因素有很多,比如:

  • Code Review(代碼審查)是個很好的測驗代碼可讀性的方法,
  • 如果你的同事可以輕松讀懂你寫的代碼,說明你的代碼可讀性很好;
  • 如果其他人在讀你的代碼時,有很多疑問,說明你的代碼可讀性并不高,

2.3 可擴展性(extensibility)

可擴展性表示代碼應對未來需求變化的能力,

如果原有的代碼已經預留好了擴展點(比如原代碼中抽象了很多底層可以復用的模塊),我們在修改很少代碼的情況下,添加新的功能,

這個時候,就可以說代碼的可擴展性好,也可以說成代碼的靈活性(flexibility)好,

影響代碼的可維護性的因素有很多,比如:

代碼的可讀性和可擴展性,在很大程度上決定了代碼是否有良好的維護性,

2.4 簡潔性(simplicity)

用最簡單的方法解決最復雜的問題,能做到這一點的,都是真正的大牛,

程式開發中有個很有名的 KISS 原則:“Keep It Simple, Stupid”,就是說要盡量保持代碼簡單,甚至于傻瓜化,這其實也意味著代碼易讀、易維護,

2.5 可復用性(reusability)

開發程序中,要多復用已有的代碼,盡力避免堆砌重復(相似)的代碼,

與可復用性相關的設計原則和實踐經驗有:

  • 與 KISS 原則齊名的 DRY(Don’t Repeat Yourself)原則,強調的就是要提高代碼的可復用性;
  • 有面向物件編程基礎的同學,應該都知道繼承、多型存在的目的之一,就是提高代碼的可復用性;
  • 單一職責原則、解耦、高內聚、模塊化等實踐經驗都能提高代碼的可復用性,

2.6 可測驗性(testability)

這個評判維度比較少提及,但卻是非常重要的代碼質量評價標準,

為了降低線上的故障率,我們的代碼需要通過測驗環節的檢驗,可測驗性良好的代碼有利于撰寫單元測驗,有利于我們在測驗環節更全面地發現問題、更快地定位到是哪些代碼產生了這些問題,

可測驗性高的代碼大多有這些特征:

職責單一;
輸入明確(可控制);
輸出清晰(可預測);
運算狀態(一般是錯誤狀態)可見;……

03 - 本篇總結

設計問題沒有標準答案,關鍵是我們要有自己的思考:

為什么有這種設計原則、思想或模式?
它能解決什么問題?有哪些應用場景?
該如何權衡、恰當地在專案中應用?

同時要認識到,上述評價維度 不是完全獨立 的,有些具有包含關系,也有的會互相影響,比如:

代碼的可讀性好、可擴展性好,就意味著代碼的可維護性好;
有些代碼的可擴展性和可復用性好,抽象出了很多介面、類和方法,但卻又導致代碼的可讀性和簡潔性下降,

現在,我們摸清了好代碼的樣子,也知道了好代碼的常見評判標準,接下來我們就要學習各類設計原則和設計思想了哦,

開始期待吧 ??


參考資料:

極客時間-王爭《設計模式之美》

著作權宣告

作者: 瘦風(https://healchow.com)

出處: 博客園 瘦風的博客(https://www.cnblogs.com/shoufeng)

感謝閱讀, 右側導航欄有「瘦風的南墻」公眾號二維碼,輸出更及時、更體系,歡迎掃碼關注??

本文著作權歸博主所有, 歡迎轉載, 但 [必須在頁面明顯位置標明原文鏈接], 否則博主保留追究相關人士法律責任的權利.

轉載請註明出處,本文鏈接:https://www.uj5u.com/ruanti/22719.html

標籤:設計模式

上一篇:Design Patterns | 01 為什么要盡早掌握設計模式

下一篇:圖解Java設計模式之單例設計模式

標籤雲
其他(157675) Python(38076) JavaScript(25376) Java(17977) C(15215) 區塊鏈(8255) C#(7972) AI(7469) 爪哇(7425) MySQL(7132) html(6777) 基礎類(6313) sql(6102) 熊猫(6058) PHP(5869) 数组(5741) R(5409) Linux(5327) 反应(5209) 腳本語言(PerlPython)(5129) 非技術區(4971) Android(4554) 数据框(4311) css(4259) 节点.js(4032) C語言(3288) json(3245) 列表(3129) 扑(3119) C++語言(3117) 安卓(2998) 打字稿(2995) VBA(2789) Java相關(2746) 疑難問題(2699) 细绳(2522) 單片機工控(2479) iOS(2429) ASP.NET(2402) MongoDB(2323) 麻木的(2285) 正则表达式(2254) 字典(2211) 循环(2198) 迅速(2185) 擅长(2169) 镖(2155) 功能(1967) .NET技术(1958) Web開發(1951) python-3.x(1918) HtmlCss(1915) 弹簧靴(1913) C++(1909) xml(1889) PostgreSQL(1872) .NETCore(1853) 谷歌表格(1846) Unity3D(1843) for循环(1842)

熱門瀏覽
  • 面試突擊第一季,第二季,第三季

    第一季必考 https://www.bilibili.com/video/BV1FE411y79Y?from=search&seid=15921726601957489746 第二季分布式 https://www.bilibili.com/video/BV13f4y127ee/?spm_id_fro ......

    uj5u.com 2020-09-10 05:35:24 more
  • 第三單元作業總結

    1.前言 這應該是本學期最后一次寫作業總結了吧。總體來說,對作業的節奏也差不多掌握了,作業做起來的效率也更高了。雖然和之前的作業一樣,作業中都要用到新的知識,但是相比之前,更加懂得了如何利用工具以及資料。雖然之間卡過殼,但總體而言,這幾次作業還算完成的比較好。 2.作業程序總結 相比前兩個單元,此單 ......

    uj5u.com 2020-09-10 05:35:41 more
  • 北航OO(2020)第四單元博客作業暨課程總結博客

    北航OO(2020)第四單元博客作業暨課程總結博客 本單元作業的架構設計 在本單元中,由于UML圖具有比較清晰的樹形結構,因此我對其中需要進行查詢操作的元素進行了包裝,在樹的父節點中存盤所有孩子的參考。考慮到性能問題,我采用了快取機制,一次查詢后盡可能快取已經遍歷過的資訊,以減少遍歷次數。 本單元我 ......

    uj5u.com 2020-09-10 05:35:48 more
  • BUAA_OO_第四單元

    一、UML決議器設計 ? 先看下題目:第四單元實作一個基于JDK 8帶有效性檢查的UML(Unified Modeling Language)類圖,順序圖,狀態圖分析器 MyUmlInteraction,實際上我們要建立一個有向圖模型,UML中的物件(元素)可能與同級元素連接,也可與低級元素相連形成 ......

    uj5u.com 2020-09-10 05:35:54 more
  • 6.1邏輯運算子

    邏輯運算子 1. && 短路與 運算式1 && 運算式2 01.運算式1為true并且運算式2也為true 整體回傳為true 02.運算式1為false,將不會執行運算式2 整體回傳為false 03.只要有一個運算式為false 整體回傳為false 2. || 短路或 運算式1 || 運算式2 ......

    uj5u.com 2020-09-10 05:35:56 more
  • BUAAOO 第四單元 & 課程總結

    1. 第四單元:StarUml檔案決議 本單元采用了圖模型決議UML。 UML檔案可以抽象為圖、子圖、邊的邏輯結構。 在實作中,圖的節點包括類、介面、屬性,子圖包括狀態圖、順序圖等。 采用了三次遍歷UML元素的方法建圖,第一遍遍歷建點,第二、三次遍歷設定屬性、連邊,實作圖物件的初始化。這里借鑒了一些 ......

    uj5u.com 2020-09-10 05:36:06 more
  • 談談我對C# 多型的理解

    面向物件三要素:封裝、繼承、多型。 封裝和繼承,這兩個比較好理解,但要理解多型的話,可就稍微有點難度了。今天,我們就來講講多型的理解。 我們應該經常會看到面試題目:請談談對多型的理解。 其實呢,多型非常簡單,就一句話:呼叫同一種方法產生了不同的結果。 具體實作方式有三種。 一、多載 多載很簡單。 p ......

    uj5u.com 2020-09-10 05:36:09 more
  • Python 資料驅動工具:DDT

    背景 python 的unittest 沒有自帶資料驅動功能。 所以如果使用unittest,同時又想使用資料驅動,那么就可以使用DDT來完成。 DDT是 “Data-Driven Tests”的縮寫。 資料:http://ddt.readthedocs.io/en/latest/ 使用方法 dd. ......

    uj5u.com 2020-09-10 05:36:13 more
  • Python里面的xlrd模塊詳解

    那我就一下面積個問題對xlrd模塊進行學習一下: 1.什么是xlrd模塊? 2.為什么使用xlrd模塊? 3.怎樣使用xlrd模塊? 1.什么是xlrd模塊? ?python操作excel主要用到xlrd和xlwt這兩個庫,即xlrd是讀excel,xlwt是寫excel的庫。 今天就先來說一下xl ......

    uj5u.com 2020-09-10 05:36:28 more
  • 當我們創建HashMap時,底層到底做了什么?

    jdk1.7中的底層實作程序(底層基于陣列+鏈表) 在我們new HashMap()時,底層創建了默認長度為16的一維陣列Entry[ ] table。當我們呼叫map.put(key1,value1)方法向HashMap里添加資料的時候: 首先,呼叫key1所在類的hashCode()計算key1 ......

    uj5u.com 2020-09-10 05:36:38 more
最新发布
  • 【中介者設計模式詳解】C/Java/JS/Go/Python/TS不同語言實作

    * 中介者模式是一種行為型設計模式,它可以用來減少類之間的直接依賴關系,
    * 將物件之間的通信封裝到一個中介者物件中,從而使得各個物件之間的關系更加松散。
    * 在中介者模式中,物件之間不再直接相互互動,而是通過中介者來中轉訊息。 ......

    uj5u.com 2023-04-20 08:20:47 more
  • 露天煤礦現場調研和交流案例分享

    他們集團的資訊化公司及研究院在一個礦區正在做智能礦山的統一平臺的 試點,專案投資大概1億,包括了礦山的各方面的內容,顯示得我們這次交流有點多余。他們2年前開始做智能礦山的規劃,有很多煤礦行業專家的加持,他們的描述是非常完美,但是去年底應該上線的平臺,現在還沒有看到影子。他們確實有很多場景需求,但是被... ......

    uj5u.com 2023-04-20 08:20:25 more
  • 《社區人員管理》實戰案例設計&個人案例分享

    設計是一個讓人夢想成真程序,開始編碼、測驗、除錯之前進行需求分析和架構設計,才能保證關鍵方面都做正確 ......

    uj5u.com 2023-04-20 08:20:17 more
  • 軟體架構生態化-多角色交付的探索實踐

    作為一個技術架構師,不僅僅要緊跟行業技術趨勢,還要結合研發團隊現狀及痛點,探索新的交付方案。在日常中,你是否遇到如下問題 “ 業務需求排期長研發是瓶頸;非研發角色感受不到研發技改提效的變化;引入ISV 團隊又擔心質量和安全,培訓周期長“等等,基于此我們探索了一種新的技術體系及交付方案來解決如上問題。 ......

    uj5u.com 2023-04-20 08:20:10 more
  • 【中介者設計模式詳解】C/Java/JS/Go/Python/TS不同語言實作

    * 中介者模式是一種行為型設計模式,它可以用來減少類之間的直接依賴關系,
    * 將物件之間的通信封裝到一個中介者物件中,從而使得各個物件之間的關系更加松散。
    * 在中介者模式中,物件之間不再直接相互互動,而是通過中介者來中轉訊息。 ......

    uj5u.com 2023-04-20 08:19:44 more
  • 露天煤礦現場調研和交流案例分享

    他們集團的資訊化公司及研究院在一個礦區正在做智能礦山的統一平臺的 試點,專案投資大概1億,包括了礦山的各方面的內容,顯示得我們這次交流有點多余。他們2年前開始做智能礦山的規劃,有很多煤礦行業專家的加持,他們的描述是非常完美,但是去年底應該上線的平臺,現在還沒有看到影子。他們確實有很多場景需求,但是被... ......

    uj5u.com 2023-04-20 08:19:07 more
  • 《社區人員管理》實戰案例設計&個人案例分享

    設計是一個讓人夢想成真程序,開始編碼、測驗、除錯之前進行需求分析和架構設計,才能保證關鍵方面都做正確 ......

    uj5u.com 2023-04-20 08:18:57 more
  • 軟體架構生態化-多角色交付的探索實踐

    作為一個技術架構師,不僅僅要緊跟行業技術趨勢,還要結合研發團隊現狀及痛點,探索新的交付方案。在日常中,你是否遇到如下問題 “ 業務需求排期長研發是瓶頸;非研發角色感受不到研發技改提效的變化;引入ISV 團隊又擔心質量和安全,培訓周期長“等等,基于此我們探索了一種新的技術體系及交付方案來解決如上問題。 ......

    uj5u.com 2023-04-20 08:18:49 more
  • 05單件模式

    #經典的單件模式 public class Singleton { private static Singleton uniqueInstance; //一個靜態變數持有Singleton類的唯一實體。 // 其他有用的實體變數寫在這里 //構造器宣告為私有,只有Singleton可以實體化這個類! ......

    uj5u.com 2023-04-19 08:42:51 more
  • 【架構與設計】常見微服務分層架構的區別和落地實踐

    軟體工程的方方面面都遵循一個最基本的道理:沒有銀彈,架構分層模型更是如此,每一種都有各自優缺點,所以請根據不同的業務場景,并遵循簡單、可演進這兩個重要的架構原則選擇合適的架構分層模型即可。 ......

    uj5u.com 2023-04-19 08:42:41 more