不可小覷的Web開發編碼規範

csdn發表於2013-10-22

  文章作者Andrey Prikaznov在DZone上分享了關於Web開發裡編碼規範的注意事項。編碼時間長的人總會遇到編碼格式標準化的問題,但是不同的專案裡需要使用不同的規則和風格來解決問題,甚至有的時候林林總總的繁雜事情會讓人頭腦發漲,那為什麼不考慮一下標準化編碼呢?換句話說,編碼規範是一套規章制度:用來為某一特定的程式語言的指令碼語言推薦程式設計風格、方法和實踐。這些規範覆蓋方方面面,包括註釋、資料夾、檔案組織、行首縮排、書面宣告、空格、命名規格、程式設計實踐和原則、構建最佳實踐等等。(以下是編譯內容)

  在編碼過程中建議能夠遵循這些規範制度,不但能幫助你改善程式碼的可讀性,還能讓後期維護變得更簡單。下面的這些案例都是基於PHP規範編寫的,但是對於所有的Web語言都是適用的。

  1. 製作表格

  在編碼的開始階段,建議你先解決這個問題:如何使用標籤或者空格?通常情況下,行首縮排在大多數程式語言裡並不是必要條件,只是當作二級符號使用。相反,開發人員只是想把程式結構更好的傳達給使用者。尤其需要注意的是,行首縮排是用來展示控制流結構之間的關係,例如:內部/外部的“條件”或“迴圈”和“程式碼”之間的關係。

  雖然標籤和空格之間的關係比較巧妙複雜,但是使用四個空格來代替一個標籤是最好的分配辦法。一起來看看例項:當我們使用不同的軟體(比如是在Total Commander裡比較兩個檔案)來審查程式碼或是比較程式碼的時候,標籤和空格看起來明顯不一樣。你只需要試著去縮排兩行程式碼,第一行使用標籤,第二行用四個空格,在Notepad++裡看起來是一樣的;但是,將這個檔案和它的備份版本(在Total Commander裡)進行比較的話,你就會注意到標籤的長度比四個空格更長(結果就是,獲得更為嚴重的格式化程式碼)。綜上所述,專案裡最好是使用四個空格,而不是標籤。這對將來的維護是有好處的。

  2. 類別名

  為了避免類別名的重複出現,同時為了讓開發者寫出更多獨具一格的類別名,請在類別名前面加上特定的字首,每個單詞以大寫字母開頭。例如:

不可小覷的Web開發編碼規範

  3. 變數名

  因為較為嚴格的資料型別在大部分Web語言裡已經不再使用了,所以為了方便起見,變數名應該以小寫字母開頭。例如:

  • i: integer
  • f: float / double
  • s: string
  • a: array
  • o: object
  • r: resource
  • b: boolean
  • is: boolean

  使用完字首之後可以接著使用Camel字型。如果你需要宣佈一個私有變數,最好是使用下劃線。

不可小覷的Web開發編碼規範

  4. 常量名

  常量是靜態的變數,這就意味著這些常量值不需要改變。照例可以在常量上使用大寫字母。例如:

不可小覷的Web開發編碼規範

  5. 功能說明(名稱和格式)

  所有的功能名稱都應該以小寫字母開頭,每個單詞都應該以大寫字母開頭。花括號應該在同一行上面(在引數列表後面)。例如:

不可小覷的Web開發編碼規範

  6. 特殊結構格式

  像if/else、for、foreach、while等等之類的特殊結構應該遵循下面的規則:

  • 在結構名稱和緊隨其後的括號之間應該有一個空格。(為了更好的閱讀)
  • 填寫在括號裡的得出的條件應該用空格分開。
  • 在左括號的後面和右括號的前面不能有空格。
  • 敞開的花括號必須是在同一條線上。
  • 內部條件應該和標籤同步縮排。

不可小覷的Web開發編碼規範

  7. 資料庫表格名稱

  在建立表格的時候,使用合乎邏輯的、易於理解的字首,同時利用下劃線將單詞分開,不必使用大寫字母。同樣的使用方法也可以用在表格區域。

不可小覷的Web開發編碼規範

  8. 專案的目錄結構

  在團隊開發專案裡,保持資料夾和文件的結構以一種合乎邏輯的順序排列是特別重要的。千萬不要把所有的東西都毫無組織的放在一個資料夾裡,否則最後得到的只能是一團糟糕的結局。就像這樣:

/root  folder
  /backup
  /cache
  /classes
  /css
  /js
  /media
    /images
    /mp3
    /video

  index.php
  otherFiles.php

  結論

  事實上,許多開發團隊一直在準備著並在使用自己的編碼規範指示和指導方針,但在任何情況下,上面所提到的編碼規範對所有程式設計人員都是有用的。好東西大家一起分享。

  原文:DZone

相關文章