統一的程式碼風格能顯著降低協作成本。以下從檔案組織、排版、命名、註解到宣告,整理一套可直接落地的 JavaScript 規範。
JavaScript 盡量獨立成 .js 檔,頁面需要時以 <script src="filename.js"> 引入。若某段程式碼並非該頁面專屬,就更不該直接寫在 HTML 裡,以便快取與複用。
縮排:同一專案應採用統一標準,建議 4 個空格。由於各編輯器對 Tab 的寬度詮釋不同,最好把 Tab 設定成 4 個空格;若無法設定,就手動敲 4 次空格。
換行:以下位置必須換行——每個獨立敘述結束後;if、else、catch、finally、while 等關鍵字之前;運算子處換行時,運算子要放在新行的行首。若因單行過長而換行,則依行長度策略處理。
每行以 80 字元為上限。確實需要斷行時,切點選在運算子或標點之後,最好落在分號或逗號後,下一行相對上一行縮排 4 個空格。這樣能有效避免複製貼上造成的內容遺漏,也更好讀。
長字串可用 + 串接,斷點盡量依語義劃分,不要在一個完整名詞中間切開。若是拼接 HTML 片段,則透過縮排讓它維持與 HTML 一致的層級結構:

也可以改用陣列 join 的方式拼接,調整縮排比 + 更靈活:

三元運算子由三部分組成,換行時依各段長度不同會有三種形態:

以下寫法則應避免:

當條件式複雜到一行放不下時,每個條件獨立一行,邏輯運算子放於行首作為分隔,或按邏輯小組分塊。最後把右括號與左大括號放在獨立一行,讓 if 的敘述區塊容易辨識:

屬性過多導致單行過長時,可依語義或邏輯分組:

以每五個一組的方式切分,既把行寬控制在合理範圍,也順帶完成了邏輯分層。元素眾多的陣列同理:


若 return 要回傳一個運算式,請把運算式與 return 寫在同一行,否則換行符可能被解析為敘述結束,造成非預期的 undefined。return 後不帶運算式時回傳 undefined;建構函式若無明確回傳,預設回傳 this。
常見命名法有四種:camel(thisIsAnApple)、pascal(ThisIsAnApple)、下劃線(this_is_an_apple)、中劃線(this-is-an-apple)。不同類型的識別字必須採用對應風格:
變數名、參數名、函式名、方法與屬性、命名空間一律使用 camel 命名法;私有(保護)成員以下劃線開頭;常數使用全大寫加下劃線,如 IS_DEBUG_ENABLED;類名與列舉名使用 pascal 命名法;列舉的屬性則用全大寫下劃線。
命名同時要顧及語義:變數用名詞;boolean 型別以 is、has 之類的前綴表明身分;函式名用動賓短語;類名用名詞。
註解力求簡潔清晰,重點放在「為什麼」以及不夠直觀的邏輯上:

(順帶一提,這種一次宣告一堆全域變數的寫法並不推薦。)
JavaScript 有兩種註解語法:建議用 // 做單行說明,用 /* ... */ 標註整段程式碼區塊,或用在函式參數、功能描述、檔案用途等較正式的場合:

另外,複製貼人之後記得檢查註解是否仍與程式碼相符。
JavaScript 雖然不強制先宣告再使用,但養成習慣很重要,這樣才能及早發現未經宣告的變數,避免它們悄悄變成隱藏的全域變數。
建議在函式開頭先用 var 一次宣告所有區域變數,為每個變數加上功能說明,並依字母排序,每個變數各占一行以便寫註解。原因在於 JavaScript 只有函式的 {} 構成作用域:用 var 宣告的是函式內有效的區域變數,漏掉 var 就會變成全域變數。

上例中宣告過的 valueA 與未宣告的 valueB 待遇截然不同。特別提醒:函式內部以 var 宣告的變數屬於區域變數,可有效避免與同名全域變數互相干擾。
函式同樣應在呼叫前宣告;內部函式則安排在 var 宣告區域變數之後,讓區域變數與內部函式的作用域一目了然。
格式上,函式名緊接左括號,右括號與後面的左大括號之間留一個空格,清楚區隔函式名、參數區與函式體的起點。若是匿名函式,function 關鍵字與左括號之間要留空格,否則容易被誤讀成函式名叫 function。
內部函式宣告範例:

從輸出的結果可以看到,inF() 只在 outF() 內部有效,區域變數 innerA 也僅對內部函式的作用域生效。這樣寫讓變數與函式的可視範圍變得非常清楚,是團隊協作時相當值得堅持的習慣。