读《代码整洁之道》前四章浅显印象 和 我所见的不整洁代码引以为戒
1.根本----良好端正的態度。
2.命名----有意義,規范,可搜索的名稱,使用源自問題領域的名稱,至少避免誤導。
3.類名----名詞或者名詞短語。
4.方法----應當是動詞或者動詞短語。
5.雙關----最好不要用這種,誰知道add是添加還是相加呢?
6.函數----要短小,印象最深的就是,一個函數只做一件事兒,即使我們需要用到try -catch,也要再獨立成一個方法,并且這個方法的第一個單詞應該是try。
7.注釋----代碼即注釋當然是最高境界,當我們想寫注釋才能更好的表達程序的時候,想想有沒有更好的修改辦法。如果必須注釋,那么注釋必須要。
????????????? 簡潔,并且注釋同樣需要維護,也許隨著代碼的演變,舊的注釋就變得沒有意義了。
?
---------------------------以上內容有待后續追加---------------------------------------------
反例:我所見到的讓人厭惡的代碼,引以為戒
???????? 1.處理相似的邏輯和功能時,完全復制代碼,毫無個人思想,甚至方法,對象,變量命名都不做修改,更甚至復制來的注釋也不修改。
???????? 2.一個方法幾十行甚至更多--一個屏幕裝不下,就拿一段jq異步代碼來說吧,異步是一件事兒,獲取異步需要傳遞的參數是一件事,異步中的success或者error的回調實現又是一件事兒,回調方法里的更多的操作還是一件事兒,種種事情一行行寫下來,還能看?
???????? 3.某些自認為大牛的人實現某些復雜的功能需求,并不感興趣完善某些校驗和細節工作,留給實習生們,然而整潔度并不讓人恭維。引起的問題一是其他人修改起來并不方便,二是其讓人在為你完善細節的時候,還要重新讀一遍兩遍代碼,我想這樣并不會提高工作效率吧。
?????????4.一個七八個參數的方法,要求傳遞的參數并沒有留下注釋?不光是修改的時候很困難,在調用方法的時候,也讓人一頭霧水。
???????? 5.某個業務基本不需要處理邏輯,能把為了方便,直接在邏輯層操作數據庫?不可思議!
?????????6.在使用aspx時,cs文件一行代碼都沒有,為了項目整體的漂亮,卻要堅持使用aspx?這樣真的漂亮?
???????? 7.幾十甚至上百個頁面,放在相同的文件夾下更好還是稍微分下類好呢!
???????? 8.一個負責增刪改查的ashx,能命名為addadmin?? 我們ManageAdmin不好嗎
?
-------15.07.29新增
? ? ? ? ?9.個人反對不同的命名空間或者程序集下下使用相同的類名,DAL層和BLL層都有一個User.cs 這樣雖然不會有什么問題,但是用UserService和UserDal不更好嗎
?
總結
以上是生活随笔為你收集整理的读《代码整洁之道》前四章浅显印象 和 我所见的不整洁代码引以为戒的全部內容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: 学生保险单在哪里查询,有以下三种方法
- 下一篇: C++虚函数表分析