以下整理 20 條常見的 JavaScript 編程規範,重點在於讓代碼更易讀、可維護,並減少常見錯誤。
- 使用外部 js 文件管理代碼,並放在 body 後方引入。
- 使用四個空格縮進,不要用 Tab。
- 每行不超過 80 字符,必要時在操作符或逗號後斷行。
- 單行註釋說明邏輯,塊註釋用於文檔。
- 變數使用前先宣告,集中宣告,避免全局變數。
- 函數使用前先宣告,並放在變數之後。
- 函數名與括號之間不留空格,參數與括號之間不留空格,函數體縮進四格。
- 命名以字母、數字、下劃線為主,變數與函數多小寫開頭,構造函數大寫開頭。
- 每行最多一條語句,並以分號結尾。
- 復合語句內部縮進四格,左括號放在行尾,右括號單獨一行並對齊。
- 控制語句即使只有一條語句,也應使用花括號。
- label 只用於 while、for、do、switch 等少數場景。
- return 表達式應與 return 同行,必要時用圓括號包住。
- if、else if、else 保持統一格式,避免複雜巢狀。
- for 與 for-in 格式統一,for-in 可用 hasOwnProperty 過濾原型屬性。
- while、do-while、switch、try 保持統一格式,case 以 break、return 或 throw 結束。
- 避免使用 continue 與 with。
- 關鍵字後、運算符兩側、逗號後留空格,函數名與括號之間不留空格。
- 用物件字面量與陣列字面量代替 new Object 與 new Array,避免逗號運算符。
- 比較相等使用 === 與 !==,避免 eval、Function 構造器與字符串計時器。
這些規範來自實務總結,可依團隊需求調整,但核心目標都是提升可讀性與穩定性。