網站開發代碼的可讀性原則
2021-05-12 分類： 網站建設
作為一名IT工程師，想要擁有良好的代碼素養，首先要讓自己的代碼可維護，不給別人的維護帶來巨大的成本和工作量，其次盡量保證代碼的美觀可讀，整潔的代碼人見人愛，如同閱讀一本好書，令人心情愉悅。對于可讀性，代碼應遵循以下三條原則：
1.可讀性基本定理
可讀性基本定理——“代碼的寫法應當使別人理解它所需的時間最小化”。
代碼風格和原則不是一概而論的，我們經常需要對一些編碼原則和方案進行取舍，例如對于三元表達式的取舍，當我們覺得兩種方案都占理時，那么唯一的評判標準就是可讀性基本定理，無論寫法多么的高超炫技，最好的代碼依舊是讓人第一時間能夠理解的代碼。
2. 有意義的名稱
代碼的可讀性絕大部分依賴于變量和函數的命名，一個好的名稱能夠一針見血地幫助維護者理解邏輯，如同寫文章中的“文筆”，文筆優異者總能將故事娓娓道來，引人入勝。
不過要起好名稱還是很難的，尤其是我們不是以英語為母語，更是添加了一層障礙，有些人認為糾結在名稱上會導致效率變低，開發第一時間應該完成需求的開發。這樣說并沒有錯，我們在開發過程中應當專注于功能邏輯，但不要完全忽視命名，所謂“文筆”是需要鍛煉的，思考的越多，命名就會愈加的水到渠成，到后來也就不太會影響工作效率了。
在這里推薦鮑勃大叔提到的童子軍規，每一次看自己的代碼，都進行一次重構，最簡單的重構便是改名，也許一開始覺得命名還比較貼合，但邏輯越寫越不符合初始的命名了，當回顧代碼時，我們可以順手對變量和方法進行重新命名，現代編輯工具也很容易做到這一點。
文不對題的命名是最可怕的，如：
這個函數被命名為check*開頭的，本意是檢測課程時間是否沖突，但內部邏輯卻包含了支付整個流程，此時對于調用者來說，如果不去細看內部邏輯，很有可能就會錯誤的認為check函數沒有副作用導致事故發生。
3.適當的注釋維護
注釋是一個比較有爭議性的話題，有人認為可讀的函數變量就很清晰，不需要額外的注釋，且注釋有不可維護性，如：
實際上，這個字段的含義早已發生了改變，但由于修改者只修改了邏輯，并沒有注意到這一行注釋，導致這個老注釋提供了錯誤信息，此時的注釋不僅變成了無效注釋，甚至會導致維護人的誤解，造成bug的產生。
對于這種情況，要么維護注釋，要么在注釋里面注明接口文檔，維護文檔，在其他情況下，適當的注釋是有必要的，對于復雜的邏輯，如果有一個簡練的注釋，對于代碼可讀性的幫助是極大的，但有些不必要的注釋可以去掉，注釋的取舍關鍵在于可讀性基本定理，如：
1.可讀性基本定理
可讀性基本定理——“代碼的寫法應當使別人理解它所需的時間最小化”。
代碼風格和原則不是一概而論的，我們經常需要對一些編碼原則和方案進行取舍，例如對于三元表達式的取舍，當我們覺得兩種方案都占理時，那么唯一的評判標準就是可讀性基本定理，無論寫法多么的高超炫技，最好的代碼依舊是讓人第一時間能夠理解的代碼。
2. 有意義的名稱
代碼的可讀性絕大部分依賴于變量和函數的命名，一個好的名稱能夠一針見血地幫助維護者理解邏輯，如同寫文章中的“文筆”，文筆優異者總能將故事娓娓道來，引人入勝。
不過要起好名稱還是很難的，尤其是我們不是以英語為母語，更是添加了一層障礙，有些人認為糾結在名稱上會導致效率變低，開發第一時間應該完成需求的開發。這樣說并沒有錯，我們在開發過程中應當專注于功能邏輯，但不要完全忽視命名，所謂“文筆”是需要鍛煉的，思考的越多，命名就會愈加的水到渠成，到后來也就不太會影響工作效率了。
在這里推薦鮑勃大叔提到的童子軍規，每一次看自己的代碼，都進行一次重構，最簡單的重構便是改名，也許一開始覺得命名還比較貼合，但邏輯越寫越不符合初始的命名了，當回顧代碼時，我們可以順手對變量和方法進行重新命名，現代編輯工具也很容易做到這一點。
文不對題的命名是最可怕的，如：
3.適當的注釋維護
注釋是一個比較有爭議性的話題，有人認為可讀的函數變量就很清晰，不需要額外的注釋，且注釋有不可維護性，如：
對于這種情況，要么維護注釋，要么在注釋里面注明接口文檔，維護文檔，在其他情況下，適當的注釋是有必要的，對于復雜的邏輯，如果有一個簡練的注釋，對于代碼可讀性的幫助是極大的，但有些不必要的注釋可以去掉，注釋的取舍關鍵在于可讀性基本定理，如：
對于上述邏輯來說，雖然通過變量可以大致猜出功能含義，但一眼看上去就能清晰掌握邏輯結構，歸功于注釋的簡明與清晰。
分享標題：網站開發代碼的可讀性原則
網頁網址：http://www.kartarina.com/news28/113378.html
成都網站建設公司_創新互聯，為您提供微信小程序、網站排名、電子商務、網站設計、網站策劃、企業建站
聲明：本網站發布的內容（圖片、視頻和文字）以用戶投稿、用戶轉載內容為主，如果涉及侵權請盡快告知，我們將會在第一時間刪除。文章觀點不代表本網站立場，如需處理請聯系客服。電話：028-86922220；郵箱：631063699@qq.com。內容未經允許不得轉載，或轉載時需注明來源： 創新互聯
猜你還喜歡下面的內容
- 再一次親身證明網站經營堅持才是最重要的 2021-05-12
- 做一個可以超越對手的網站 2021-05-12
- 在建站設計中怎樣做首圖？ 2021-05-12
- 互聯網新經濟推動經濟轉型，構筑發展優勢 2021-05-12
- 如何優化提高關鍵詞的質量度? 2021-05-12
- 幫助企業解答網站類型的一篇文章絕對值得一看 2021-05-12
- 如何吸引搜索引擎來抓取收錄你的網頁 2021-05-12
- 甲骨文推出世界第一個自治操作系統 2021-05-12
- 網頁設計與逆向思維 2021-05-12
- 做外鏈時需注意事項-網站優化 2021-05-12
- SEO網站優化過程中的幾個誤區 2021-05-12
- 個人客戶網站開發建設的決策過程 2021-05-12
- “智慧酒店”成為傳統酒店產業智能化重要手段 2021-05-12
- 網站建設三部曲 2021-05-12
- PHP語言運行環境分析 2021-05-12
- 淮南網站設計公司哪家好？ 2021-05-12
- 網站過度優化的具體表現有哪些? 2021-05-12
- 建材網站建設方案 2021-05-12
- 修煉設計師難以被復制的能力 2021-05-12