代碼整潔(學(xué)習(xí)筆記)

軟件開發(fā)中的 5S 原則:

  • 整理:命名的規(guī)范
  • 整頓:把你的代碼放在它應(yīng)該在的地方
  • 清楚:整潔代碼
  • 清潔:代碼風(fēng)格、實(shí)踐手段
  • 身美:不斷改進(jìn)

有意義的命名

  • 變量名、方法名:使用小駝峰法 --- 除第一個單詞之外,其他單詞首字母大寫
eg:
var myStudents;
function getStudentById(){}
  • 類名:使用大駝峰法 --- 所有單詞的首字母都大寫
eg:
class BaseUser{}

好的命名遵循下列的規(guī)范:

  • 名副其實(shí):不需要被注釋也應(yīng)該被理解、看懂。怎么用、做什么事、為什么存在
  • 避免誤導(dǎo):(I 、O),這到底是 I 還是 1,是 O 還是 0;(傻傻分不清)
  • 做有意義的區(qū)分:
    不要使用 a1、a2、a3
    不要說廢話(student 就不要再寫成 studentInfo 或者 studentData 了)
  • 使用讀得出來的名稱
  • 使用可搜索的名稱:不要使用硬編碼,盡量使用常量替代
  • 一致的命名規(guī)則:比如查找都用 find**
  • 不要使用雙關(guān)語

明了的函數(shù)

  • 短小
  • 每一個函數(shù)/方法應(yīng)該只干一件
  • 函數(shù)參數(shù):
    一元參數(shù):有輸入應(yīng)該也有輸出
    二元參數(shù):盡量不要使用,除非參數(shù)是有序組成的(new Point(x,y))
    如果參數(shù)個數(shù)超過兩個,考慮下把參數(shù)封裝一下在傳過去
  • 別重復(fù)自己

注釋

法律信息
提供信息的注釋(時間格式...)
對意圖的解釋
警告
TODO
公共 API

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成,瀏覽時請結(jié)合常識與多方信息審慎甄別。
平臺聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點(diǎn),簡書系信息發(fā)布平臺,僅提供信息存儲服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

  • iOS編程規(guī)范0規(guī)范 0.1前言 為??高產(chǎn)品代碼質(zhì)量,指導(dǎo)廣大軟件開發(fā)人員編寫出簡潔、可維護(hù)、可靠、可 測試、高效...
    iOS行者閱讀 4,611評論 21 35
  • 推薦文章:禪與 Objective-C 編程藝 前言 為??高產(chǎn)品代碼質(zhì)量,指導(dǎo)廣大軟件開發(fā)人員編寫出簡潔、可維護(hù)、...
    MurtoTien閱讀 2,945評論 0 1
  • 該喝的酒多喝兩杯酒精教會你語言和行動說話開始飄離地心在空中變換著色彩 遺忘一顆巨大的石頭讓它緩緩沉入大海來來往往的...
    無法登陸閱讀 231評論 0 2
  • 住在海邊最大的好處就是一年四季可以吃到應(yīng)季的海鮮,而四季中海鮮最為豐盛的季節(jié)恰恰就是在深秋時節(jié),魚兒蝦蟹正肥。 身...
    黑白無閱讀 750評論 5 9
  • 我害怕啊 我害怕遲早被這個世俗打敗 我害怕年齡越來越大,我害怕我碌碌無為 我害怕我早早走上婚姻再也不提愛...
    也有一個林夕夢閱讀 284評論 0 1

友情鏈接更多精彩內(nèi)容