行與縮進

　　語句行

　　盡可能不要讓每行超過 120 個字符;

　　語句必須以分號作為結(jié)束符, 不要忽略分號;

　　空格

　　數(shù)值操作符(如, +/-/*/% 等)兩邊留空;

　　賦值操作符/等價判斷符兩邊留一空格;

　　for 循環(huán)條件中, 分號后留一空格;

　　變量聲明語句, 數(shù)組值, 對象值及函數(shù)參數(shù)值中的逗號后留一空格;

　　空行不要有空格;

　　行尾不要有空格;

　　逗號和冒號后一定要跟空格;

　　點號前后不要出現(xiàn)空格;

　　空對象和數(shù)組不需要填入空格;

　　函數(shù)名末尾和左括號之間不要出現(xiàn)空格;

　　空行

　　邏輯上獨立的代碼塊使用空行分隔;

　　文件末尾留 1~2 個空行;

　　不要吝嗇空行. 盡量使用空行將邏輯相關(guān)的代碼塊分割開, 以提高程序的可讀性.

　　縮進

　　以 4 個空格為一縮進層次;

　　變量聲明:

　　多個變量聲明時, 適當換行表示;

　　參照 var 關(guān)鍵字, 縮進一層次;

　　函數(shù)參數(shù):

　　函數(shù)參數(shù)寫在同一行上;

　　傳遞匿名函數(shù)時, 函數(shù)體應(yīng)從調(diào)用該函數(shù)的左邊開始縮進;

　　數(shù)組和對象初始化時:

　　如果初始值不是很長, 盡量保持寫在單行上;

　　初始值占用多行時, 縮進一層次;

　　對象中, 比較長的變量/數(shù)值, 不要以冒號對齊;

　　二元/三元操作符:

　　操作符始終跟隨前行;

　　實在需要縮進時, 按照上述縮進風格;

　　表達式中的縮進同變量聲明時;

　　括號

　　原則: 不要濫用括號, 必要時一定要使用.

　　if/else/while/for 條件表達式必須有小括號;

　　語句塊必須有大括號;

　　一元操作符(如 delete, typeof, void)或在某些關(guān)鍵詞(如 return, throw, case, new) 之后, 不要使用括號;

　　變量

　　變量如有較廣的作用域, 使用全局變量; 如果是在類中, 可以設(shè)計成為一個類的成員;

　　函數(shù)體中, 多個局部變量集中在一起聲明, 避免分散;

　　適當延遲變量的初始化;

　　字符串

　　JS 代碼中, 單行字符串使用單引號;

　　JS 代碼中, 多行字符串使用 + 拼接形式, 不要使用 \ 拼接;

　　HTML 中 Element 屬性, 使用雙引號;

　　命名規(guī)范

　　原則： * 盡量避免潛在沖突; * 精簡短小, 見名知意;

　　普通變量統(tǒng)一使用駝峰形式;

　　常量使用全部大寫, 多個單詞以下劃線分隔;

　　枚舉量, 同常量;

　　私有變量, 屬性和方法, 名字以下劃線開頭;

　　保護變量, 屬性和方法, 名字同普通變量名;

　　方法和函數(shù)的可選參數(shù), 名字以 opt_ 開頭, 使用 @param 標記說明;

　　方法和函數(shù)的參數(shù)個數(shù)不固定時:

　　可添加參數(shù) var_args 為參數(shù)個數(shù);

　　取代使用 arguments;

　　使用 @param 標記說明;

　　Getter/Setter 命名:

　　以 getFoo/setFoo(value) 形式;

　　布爾類型使用 isFoo()/hasFoo()/canDo()/shouldDO() 也可;

　　命名空間:

　　為全局代碼使用命名空間, 如 sloth.*;

　　外部代碼和內(nèi)部代碼使用不同的命名空間;

　　重命名那些名字很長的變量, 不要在全局范圍內(nèi)創(chuàng)建別名, 而僅在函數(shù)塊作用域中使用;

　　文件名應(yīng)全部使用小寫字符, 且不包含除 - 和 _ 外的標點符號;

　　臨時的重復(fù)變量建議以 i, j, k, ..., 命名;

 

 

　　聲明變量時, 必須加上 var 關(guān)鍵字.

　　盡量減少全局變量的使用.

　　語句總是以分號結(jié)尾.

　　不要在塊內(nèi)聲明函數(shù).

　　標準特性優(yōu)于非標準特性(如果類庫有提供, 優(yōu)先使用類庫中的函數(shù)).

　　不要封裝基本類型.

　　只在解析序列化串時使用 eval() .

　　禁止使用 with .

　　減少使用 continue 和 break .

　　僅在函數(shù)內(nèi)使用 this .

　　使用 Array/Object 直接量, 避免使用 Array/Object 構(gòu)造器.

　　禁止修改內(nèi)置對象的原型.

該文章在 2012/5/2 12:23:46 編輯過