首頁 後端開發 php教程 寫出高品質的程式碼-從命名入手

寫出高品質的程式碼-從命名入手

Jul 25, 2016 am 08:43 AM


程式設計初學者總是把大量的時間用在學習程式語言、文法、技巧和程式設計工具的使用上。他們認為,如果掌握了這些技術技巧,他們就能成為不錯的程式設計師。然而,電腦程式設計的目的並不是關於精通這些技術、工具的,它是關於針對特定領域裡的特定問題創造出相應的解決方案,程式設計師透過相互合作來實現這些。所以,很重要的一點,你需要能精確的用程式碼表達出你的思想,讓其他人透過程式碼能明白你的意圖。

        讓我們先來看看程式設計大師 Robert C. Martin 的傑作《Clean Code》裡的一句話:

註解的目的是為了彌補程式碼本身在表達上的不足。

        這句話可以簡單的理解為如果你的程式碼需要註釋,最有可能是你的程式碼寫的很爛。同樣,如果在沒有註解的情況下你無法用程式碼完整的表達你對一個問題或一個演算法的思路,那這就是一個失敗的訊號。最終,這意味著你需要用註解來闡明一部分的思想,而這部分在程式碼裡是看不出來的。好的程式碼能夠讓任何人在不需要任何註解的情況下看懂。好的編碼風格能將所有有助於理解這個問題的所有資訊都蘊含在程式碼裡。
   在程式理論中,有一個概念叫做「自我描述的原始碼」。對於一段程式碼,一種常見的自我描述機制是遵循某種非嚴格定義的變數、方法、物件命名規則。這樣做的主要作用就是讓原始程式碼更易讀易懂。所以,也就更容易維護和擴充。
      這篇文章裡,我將舉出一些例子,說明什麼是“不好的代碼”,什麼是“清楚的代碼”

命名要能揭示意圖

   如何命名,在程式設計中這永遠都是個老大難問題。有些程式設計師喜歡簡化、縮短或加密名稱,使得只有他們自己能懂。下面讓我們來看一些例子:

不好的程式碼:
int d;// 天數 int ds;int dsm;int faid;
        「d」可以表示任何東西。作者使用註釋來表明他的意圖,卻沒有選擇用代碼來表示。而“faid”很容易導致誤解為ID。

清楚的程式碼:
int elapsedTimeInDays;int daysSinceCreation;int daysSinceModification;int fileAgeInDays;
;
命名時避免意義引起誤解的訊息

   錯誤的訊息比沒有訊息更糟糕。有些程式設計師喜歡「隱藏」一些重要訊息,有時候他們也會寫出一些讓人誤解的程式碼。

不好的程式碼:

Customer[] customerList;Table theTable;
         變數「customerList」其實不是個 list。它是一個普通的 array (或客戶集合)。除此之外,「theTable」是一個 Table 類型的物件(你可以用 IDE 容易的發現它的類型),「the」這個字是個不必要的干擾。

清楚的程式碼:

Customer[] customers;Table table;
命名要有適當的長度

    在高階程式語言中,變數名稱的長度通常較不限制。變數名幾乎可以任何長度。雖然如此,這也可能使程式碼變得鬧心。

不好的程式碼:
var theCustomersListWithAllCustomersIncludedWithoutFilter;var list;
        好的名稱應該只含有必要的字彙來表示一個概念。任何不必要的字詞都會使名稱變長、難於理解。名稱越短越好,前提是能在上下文中表達完整的意思(下訂單這個場景中,“customersInOrder” 要比 “list” 好)。

清楚的程式碼:
var allCustomers;var customersInOrder;
命名時編碼規範保持一致,讓規範幫助理解代碼

        所有的程式設計技術(語言)都有自己的“風格”,稱為編碼規格。程式設計師應該在寫程式碼時遵循這些習慣,因為其他的程式設計師也知道這些,並且以這種風格編寫。下面我們來看一個沒有明顯規範的不好的程式碼例子。下面的這段程式碼並沒有遵循很好的已知的「編碼規範」(例如 PascalCase, camelCase, Hungarian 規範)。更糟的是,這有一個毫無意義的 bool 變數「change」。這是動詞(用來描述動作),但這裡的 bool 值是來描述一個狀態,所以,這裡應該用一個形容詞比較合適。

不好的程式碼:
const int maxcount = 1bool change = truepublic interface Repositoryprivate string NAMEpublic class personaddressvoid getpublic interface Repositoryprivate string NAMEpublic class personaddressvoid getpublics()
     一段程式碼,只看它的一部分,你就應該直接明白它是什麼類型,只需要看它的命名方法。
      例如:你看到了“_name”,你就能知道它是私有變數。你應該在任何地方都利用這種表示方法,沒有例外情況。

清楚的程式碼:
const int MAXCOUNT = 1bool isChanged = truepublic interface IRepositoryprivate string _namepublic class PersonfaceAddress
命名時相同的概念用相同的字表達

        定義概念很難。在軟體開發過程中,很多時間都花在分析業務場景、思考正確的定義裡面所有的元素。這些概念永遠都是讓程式設計師頭痛的事。

不好的程式碼://1. void LoadSingleData ()void FetchDataFiltered ()Void GetAllData ()//2. void SetDataToView (); (int value)

首先:
  代碼的作者試圖表達“get the data”的概念,他使用了多個詞“load”,“getch”,“get” 。一個概念只用一個字表達就行了(在同一個場景中)。
  第二:
  “set”這個字用在了2 個概念裡:第一是“data loading to view”,第二個是「setting a value of object」。這是兩個不同的概念,你應該使用不同的字。

清楚的程式碼:
//1. void GetSingleData ()void GetDataFiltered ()Void GetAllData ()//2. void LoadDataToView ();void SetObjectValue (int value)

命名時使用跟業務領域相關的字

  程式設計師寫的所有程式碼都是跟業務領域場景邏輯相連的。為了讓所有關係到這個問題的人都能更好的理解,程式中應該使用在領域環境中有意義的名稱。

不好的程式碼:
public class EntitiesRelation{Entity o1;Entity o2;}
  當在編寫針對某個領域的程式碼時,你應該始終考慮使用領域有聯繫的名稱。在將來,當另外一個人(不僅是程式設計師,也許是測試人員)接觸你的程式碼時,他能輕鬆的理解這個業務領域裡你的程式碼是什麼意思(不需要業務邏輯知識)。你首先考慮的應該是業務問題,之後才是如何解決。

清楚的程式碼:

public class ProductWithCategory{Entity product;Entity category;}
命名時使用在特定環境裡有意義的字

  程式碼裡名稱都有自己的上下文。上下文對於理解一個名稱非常重要,因為它能提供額外的資訊。讓我們來看看一個典型的「地址」上下文:

不好的程式碼:

string addressCity;string addressHomeNumber;string addressPostCode;
     在大多數情況中,「Post Code」通常是地址的一部分,很顯然,郵遞區號不能單獨使用(除非你是在開發一個專門處理郵編的應用)。所以,沒有必要在「PostCode」的前面加上「address」。更重要的,所以的這些資訊都有一個上下文容環境,一個命名空間,一個類別。
      在物件導向程式設計中,這裡應該用一個「Address」類別來表示這個位址資訊。

清楚的程式碼:
class Address{string city;string homeNumber;string postCode;}
命名方法總結

  概述起來,做為程式設計師,你應該:
· 命名是來表達概念的
·
命名是來表達概念的
·
注意名稱長度,名稱裡只該含有必要的詞語
·
編碼規範有助於理解代碼,你應該使用它
·
名稱不要混用
·
名稱裡要有意義,在上下文裡有意義



由於上傳附件及文字限制,有時部分圖片、文字可能顯示不了,詳情請見:http://mp.weixin.qq.com/s?__biz=MzI5ODI3NzY2MA==&mid=10000563&idx=2&sn=528dc490ec0d000b8 > 歡迎大家一起交流。 掃描以下二維碼,獲取更多更精美文章! (掃碼關注有意不到的驚喜的哦!!)


關注我們微信訂閱號碼( uniguytech100) 與服務號碼(uniguytech),獲取更多更精美文章!
也歡迎加入【大家技術網討論QQ群】,群號:256175955,請備註你個人的介紹!讓我們一起聊聊it的那些事吧!


本網站聲明
本文內容由網友自願投稿,版權歸原作者所有。本站不承擔相應的法律責任。如發現涉嫌抄襲或侵權的內容,請聯絡admin@php.cn

熱AI工具

Undresser.AI Undress

Undresser.AI Undress

人工智慧驅動的應用程序,用於創建逼真的裸體照片

AI Clothes Remover

AI Clothes Remover

用於從照片中去除衣服的線上人工智慧工具。

Undress AI Tool

Undress AI Tool

免費脫衣圖片

Clothoff.io

Clothoff.io

AI脫衣器

Video Face Swap

Video Face Swap

使用我們完全免費的人工智慧換臉工具,輕鬆在任何影片中換臉!

熱工具

記事本++7.3.1

記事本++7.3.1

好用且免費的程式碼編輯器

SublimeText3漢化版

SublimeText3漢化版

中文版,非常好用

禪工作室 13.0.1

禪工作室 13.0.1

強大的PHP整合開發環境

Dreamweaver CS6

Dreamweaver CS6

視覺化網頁開發工具

SublimeText3 Mac版

SublimeText3 Mac版

神級程式碼編輯軟體(SublimeText3)

在PHP API中說明JSON Web令牌(JWT)及其用例。 在PHP API中說明JSON Web令牌(JWT)及其用例。 Apr 05, 2025 am 12:04 AM

JWT是一種基於JSON的開放標準,用於在各方之間安全地傳輸信息,主要用於身份驗證和信息交換。 1.JWT由Header、Payload和Signature三部分組成。 2.JWT的工作原理包括生成JWT、驗證JWT和解析Payload三個步驟。 3.在PHP中使用JWT進行身份驗證時,可以生成和驗證JWT,並在高級用法中包含用戶角色和權限信息。 4.常見錯誤包括簽名驗證失敗、令牌過期和Payload過大,調試技巧包括使用調試工具和日誌記錄。 5.性能優化和最佳實踐包括使用合適的簽名算法、合理設置有效期、

會話如何劫持工作,如何在PHP中減輕它? 會話如何劫持工作,如何在PHP中減輕它? Apr 06, 2025 am 12:02 AM

會話劫持可以通過以下步驟實現:1.獲取會話ID,2.使用會話ID,3.保持會話活躍。在PHP中防範會話劫持的方法包括:1.使用session_regenerate_id()函數重新生成會話ID,2.通過數據庫存儲會話數據,3.確保所有會話數據通過HTTPS傳輸。

描述紮實的原則及其如何應用於PHP的開發。 描述紮實的原則及其如何應用於PHP的開發。 Apr 03, 2025 am 12:04 AM

SOLID原則在PHP開發中的應用包括:1.單一職責原則(SRP):每個類只負責一個功能。 2.開閉原則(OCP):通過擴展而非修改實現變化。 3.里氏替換原則(LSP):子類可替換基類而不影響程序正確性。 4.接口隔離原則(ISP):使用細粒度接口避免依賴不使用的方法。 5.依賴倒置原則(DIP):高低層次模塊都依賴於抽象,通過依賴注入實現。

在PHPStorm中如何進行CLI模式的調試? 在PHPStorm中如何進行CLI模式的調試? Apr 01, 2025 pm 02:57 PM

在PHPStorm中如何進行CLI模式的調試?在使用PHPStorm進行開發時,有時我們需要在命令行界面(CLI)模式下調試PHP�...

PHP 8.1中的枚舉(枚舉)是什麼? PHP 8.1中的枚舉(枚舉)是什麼? Apr 03, 2025 am 12:05 AM

PHP8.1中的枚舉功能通過定義命名常量增強了代碼的清晰度和類型安全性。 1)枚舉可以是整數、字符串或對象,提高了代碼可讀性和類型安全性。 2)枚舉基於類,支持面向對象特性,如遍歷和反射。 3)枚舉可用於比較和賦值,確保類型安全。 4)枚舉支持添加方法,實現複雜邏輯。 5)嚴格類型檢查和錯誤處理可避免常見錯誤。 6)枚舉減少魔法值,提升可維護性,但需注意性能優化。

如何在系統重啟後自動設置unixsocket的權限? 如何在系統重啟後自動設置unixsocket的權限? Mar 31, 2025 pm 11:54 PM

如何在系統重啟後自動設置unixsocket的權限每次系統重啟後,我們都需要執行以下命令來修改unixsocket的權限:sudo...

解釋PHP中的晚期靜態綁定(靜態::)。 解釋PHP中的晚期靜態綁定(靜態::)。 Apr 03, 2025 am 12:04 AM

靜態綁定(static::)在PHP中實現晚期靜態綁定(LSB),允許在靜態上下文中引用調用類而非定義類。 1)解析過程在運行時進行,2)在繼承關係中向上查找調用類,3)可能帶來性能開銷。

See all articles