摘要：用且只用一個(gè)完成這一需求。執(zhí)行時(shí)可以增加規(guī)則對(duì)要變量的合法性進(jìn)行判斷。繼承該類時(shí)可以重載默認(rèn)行為。讓對(duì)象擁有私有成員。理想情況下，應(yīng)將調(diào)用其他函數(shù)的函數(shù)寫在被調(diào)用函數(shù)的上方。避免位置標(biāo)記避免在源文件中寫入法律評(píng)論參考

使用有意義、可讀性好的變量

使用 ES6 的 const 聲明常量

對(duì)功能類似的變量名采用統(tǒng)一的命名風(fēng)格

使用易于檢索名稱

舉例

// 反例
for (var i = 0; i < 525600; i++) {
  runCronJob();
}

// 正例
var MINUTES_IN_A_YEAR = 525600;
for (var i = 0; i < MINUTES_IN_A_YEAR; i++) {
  runCronJob();
}

使用說(shuō)明變量（即有意義的變量名）

顯式優(yōu)于隱式（變量名盡量簡(jiǎn)潔明了）

避免重復(fù)的描述

避免無(wú)意義的條件判斷

舉例

var currentPage="";
var pageNumInfo = JSON.parse(localStorage.getItem("pageNumInfo"));
if (pageNumInfo) {
    currentPage = parseInt(pageNumInfo[0].pageNum);
} else {
    currentPage = 1;
}
// 以上代碼片段可用以下代碼取代
var pageNumInfo = JSON.parse(localStorage.getItem("pageNumInfo")); 
var currentPage = parseInt(pageNumInfo[0].pageNum) || 1;

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

函數(shù)參數(shù)理想情況下應(yīng)該不超過(guò) 2 個(gè)。當(dāng)確實(shí)需要多個(gè)參數(shù)時(shí)，大多情況下可以考慮將這些參數(shù)封裝成一個(gè)對(duì)象。

保證函數(shù)功能的單一性

功能不單一的函數(shù)將導(dǎo)致難以重構(gòu)、測(cè)試和理解。功能單一的函數(shù)易于重構(gòu)，并使代碼更加干凈。

提高函數(shù)名的可讀性（函數(shù)名應(yīng)明確表明其功能）

函數(shù)應(yīng)該只做一層抽象

當(dāng)函數(shù)需要的抽象多于一層時(shí)通常意味著函數(shù)功能過(guò)于復(fù)雜，需將其進(jìn)行分解以提高其可重用性和可測(cè)試性。

避免在一個(gè)函數(shù)中寫重復(fù)的代碼

采用默認(rèn)參數(shù)精簡(jiǎn)代碼

使用 Object.assign() 設(shè)置默認(rèn)對(duì)象

不要使用標(biāo)記（Flag）作為函數(shù)參數(shù)（會(huì)破壞函數(shù)功能的單一性）

避免副作用

函數(shù)副作用：當(dāng)函數(shù)產(chǎn)生了除了“接受一個(gè)值并返回一個(gè)結(jié)果”之外的行為時(shí)，稱該函數(shù)產(chǎn)生了副作用。比如寫文件、修改全局變量等。
程序在某些情況下確實(shí)需要副作用這一行為，如先前例子中的寫文件。這時(shí)應(yīng)該將這些功能集中在一起，不要用多個(gè)函數(shù)/類修改某個(gè)文件。用且只用一個(gè) service 完成這一需求。

不要寫全局函數(shù)

采用函數(shù)式編程

封裝判斷條件

避免“否定條件”的判斷

避免條件判斷

許多情況下通過(guò)使用多態(tài)(polymorphism)可以達(dá)到同樣的目的。

// 反例
class Airplane {
  //...
  getCruisingAltitude() {
    switch (this.type) {
      case "777":
        return getMaxAltitude() - getPassengerCount();
      case "Air Force One":
        return getMaxAltitude();
      case "Cessna":
        return getMaxAltitude() - getFuelExpenditure();
    }
  }
}

// 正例
class Airplane {
  //...
}

class Boeing777 extends Airplane {
  //...
  getCruisingAltitude() {
    return getMaxAltitude() - getPassengerCount();
  }
}

class AirForceOne extends Airplane {
  //...
  getCruisingAltitude() {
    return getMaxAltitude();
  }
}

class Cessna extends Airplane {
  //...
  getCruisingAltitude() {
    return getMaxAltitude() - getFuelExpenditure();
  }
}

避免類型判斷

避免過(guò)度優(yōu)化

無(wú)效代碼及時(shí)刪除

使用 getters 和 setters

使用 getters 和 setters 獲取對(duì)象的數(shù)據(jù)遠(yuǎn)比直接使用點(diǎn)操作符具有優(yōu)勢(shì)，為什么呢？？
1、當(dāng)需要對(duì)獲取的對(duì)象屬性執(zhí)行額外操作時(shí)。
2、執(zhí)行 set 時(shí)可以增加規(guī)則對(duì)要變量的合法性進(jìn)行判斷。
3、封裝了內(nèi)部邏輯。
4、在存取時(shí)可以方便的增加日志和錯(cuò)誤處理。
5、繼承該類時(shí)可以重載默認(rèn)行為。
6、從服務(wù)器獲取數(shù)據(jù)時(shí)可以進(jìn)行懶加載。

讓對(duì)象擁有私有成員。（可以通過(guò)閉包實(shí)現(xiàn)）

列表項(xiàng)目

單一職責(zé)原則（SRP）

開閉原則（OCP）

代碼實(shí)體(類，模塊，函數(shù)等)應(yīng)該易于擴(kuò)展，難于修改。
即代碼模塊的功能應(yīng)該要方便用戶拓展而不是修改源碼

利斯科夫替代原則（LSP）

子類對(duì)象應(yīng)該能夠替換其超類（父類）對(duì)象被使用。

接口隔離原則（ISP）

客戶端不應(yīng)該依賴它不需要的接口，一個(gè)類對(duì)另一個(gè)類的依賴應(yīng)該建立在最小的接口上。

依賴反轉(zhuǎn)原則（DIP）

該原則有兩個(gè)核心點(diǎn)：
1、高層模塊不應(yīng)該依賴于低層模塊。他們都應(yīng)該依賴于抽象接口。
2、抽象接口應(yīng)該脫離具體實(shí)現(xiàn)，具體實(shí)現(xiàn)應(yīng)該依賴于抽象接口。

使用 ES6 的 classes 而不是 ES5 的 Function

典型的 ES5 的類(function)在繼承、構(gòu)造和方法定義方面可讀性較差。
當(dāng)需要繼承時(shí)，優(yōu)先選用 classes。
但是，當(dāng)在需要更大更復(fù)雜的對(duì)象時(shí)，最好優(yōu)先選擇更小的 function 而非 classes。

使用方法鏈

優(yōu)先使用組合模式而非繼承

單元測(cè)試，單一的測(cè)試每個(gè)概念

用 Promise 替代回調(diào)（支持 ES6 的情況，優(yōu)先使用）

async 和 await（支持 ES7 的情況，優(yōu)先使用）

try/catch 捕獲異常

不要忽略被拒絕的 promises

大小寫一致

調(diào)用函數(shù)的函數(shù)和被調(diào)函數(shù)應(yīng)放在較近的位置

當(dāng)函數(shù)間存在相互調(diào)用的情況時(shí)，應(yīng)將兩者置于較近的位置。理想情況下，應(yīng)將調(diào)用其他函數(shù)的函數(shù)寫在被調(diào)用函數(shù)的上方。

只對(duì)存在一定業(yè)務(wù)邏輯復(fù)雜性的代碼進(jìn)行注釋。注釋并不是必須的，好的代碼是能夠讓人一目了然，不用過(guò)多無(wú)謂的注釋。

被注釋掉的代碼及時(shí)刪除

不需要版本更新類型注釋。需要時(shí)可以使用 git log 獲取歷史版本。

避免位置標(biāo)記

避免在源文件中寫入法律評(píng)論

參考