JavaScript 語法鬆散,若無規範極易產生維護噩夢。本文依據業界慣例與經驗,提出檔案引用、縮排、註解、命名、宣告、語句、作用域等規範建議。
.js 檔,HTML 中以 <script src="...></script> 引用。// 用於單行/行尾註解;/* ... */ 用於區塊註解、函式/檔案標頭說明。// 好:解釋業務邏輯
// 等待 50 秒後執行 f1(非設定超時時間)
setTimeout(f1, 50000);
// 差:重複程式碼字面意義
// 將 valueA 初始化為 0
var valueA = 0;
camelCase,首字母小寫。PascalCase。UPPER_SNAKE_CASE。_private;避免使用 $ 開頭(保留給系統/框架)。var/let/const 宣告**,避免隱性全域變數。function example() {
var count = 0; // 計數器
var userName = ""; // 使用者名稱
// ...
}
function foo();匿名函式 function () 之間留空格。function foo() {。var innerA = 1; // 全域
function outF() {
var innerA = 2; // 區域,遮蔽全域
function inF() {
alert(innerA); // 2(閉包捕捉區域變數)
}
inF();
}
outF();
alert(innerA); // 1(全域未被修改)
{ 置於行尾,} 獨立一行並與對應 { 對齊。