對熟悉 C/C++ 或 Java 的工程師來說,JavaScript 顯得靈活又寬鬆:變數隨用隨宣告、語句結尾的分號可以省、字串和數字可以直接相加、參數多一個少一個也不報錯。從嚴格的靜態語言轉過來,會有一種「終於自由了」的輕鬆感。
但語法寬鬆正是 JavaScript 最需要紀律的地方。開發過程中的修修補補,最後往往變成維護者的噩夢。軟體的長期價值與代碼品質成正比,而 JavaScript 更特別——它會直接送到客戶的瀏覽器裡執行,跟使用者面對面,品質問題藏不住。
JavaScript 應該盡量放在獨立的 .js 檔中,需要時再以 script 標籤引入,而不是散落在 HTML 各處。這樣做除了便於快取與維護,也讓非同步載入、合併壓縮等優化有操作空間。
簡單語句方面,該說的還是那句:分號要寫。同時一行只放一個語句。如果一個賦值語句的右值是很長的函式呼叫或物件字面值而必須跨行,請特別注意結尾的分號不能漏。
原因在於 JavaScript 的所有運算式都可以當語句,而直譯器遇到換行時可能把它解析為語句結束。不規範的換行加上消失的分號,很容易引入一些「看起來沒錯但行為不對」的錯誤。
複合語句——包含 if、for、while、do、switch、try…catch 等程式碼區塊、函式主體、物件定義——都應該放在大括號裡:
'{' 放在行末,標誌區塊開始。
'}' 放在一行開頭,並與對應 '{' 所在行的開頭對齊,讓整段複合語句的層級一眼可見。
被包住的程式碼再縮排 4 個空格。
即使區塊裡只有一句話,也請加上大括號。少了它現在不會出錯,但哪天有人補了第二行,漏掉的大括號就會造成編譯錯誤或更難纏的邏輯錯誤。
return 語句要格外小心:若要回傳運算式,請把運算式和 return 寫在同一行,否則換行可能被解析成語句結束,導致函式提前回傳 undefined。順帶記住兩個預設行為——return 後頭沒有運算式時回傳 undefined,而建構子(constructor)的預設回傳值是 this。
適當的空行與空白能大幅提升可讀性,讓程式邏輯自己浮出來。幾個慣例:
關鍵字後若有括號,關鍵字與左括號之間留一個空白,例如 for (、if (、while (。函式名稱與括號之間則不留空白;但若是匿名函式,function 與左括號之間必須留空白,否則編輯器可能把 function 誤認為函式名稱。
二元運算子的兩側留空白,例外是左括號、左方括號與作用域點。一元運算子(typeof 這類關鍵字除外)與運算元之間不留空白。
逗號後面留空白,讓參數與變數的區隔清楚。分號代表語句結束所以通常換行;但在 for 的條件式中,分號之後反而應該留一個空白。
要建立空物件與空陣列,很多人直覺寫 new Object() 和 new Array()。其實 {} 與 [] 就足夠了,而且更簡潔、執行更快,也避開了 new Array(3) 這類歧義呼叫帶來的困惑。
JavaScript 只有函式作用域,沒有區塊作用域,這點和 C 家族語言的直覺不同。善用 IIFE 或巢狀函式把變數與輔助函式包在內部,讓哪些是本檔私有的、哪些是刻意對外公開的變得清楚,是控制污染最實際的手段。
這些規則看起來瑣碎,但它們的價值在於累積。當一個專案有五萬行 JavaScript 而有五個人維護時,規範就是唯一讓它還能被讀懂的东西。