JavaScript代碼整潔之道——好代碼和壞代碼

JavaScript代碼整潔之道——好代碼和壞代碼

概述

我們之道作為一個(gè)碼農(nóng)搂鲫,不論其實(shí)現(xiàn)如何,功能怎樣磺平,寫的一手清晰靠譜的代碼是其代碼功力的體現(xiàn)魂仍。好的、清潔的代碼可以方便自己以后維護(hù)拣挪,讓你的繼任者馬上能接手維護(hù)它擦酌,而不是給你檫屁股,被人戳脊梁骨媒吗、被罵垃圾代碼仑氛。所以,寫清潔地代碼非常重要。

那么什么才是清潔代碼的呢锯岖?不言而喻介袜,清潔的代碼就是可以讓人易于人理解、易于更改出吹、方便擴(kuò)展的代碼遇伞。寫清潔的代碼要常捫心自問:

為什么要這樣寫?

為什么要在這兒寫捶牢?

為什么不換個(gè)寫法鸠珠?

Robert C. Martin在《代碼整潔之道》一書中說過:

JavaScript代碼整潔之道——好代碼和壞代碼

就算是的壞代碼也能運(yùn)行,但如果代碼不干凈秋麸,也能會(huì)讓你的開發(fā)團(tuán)隊(duì)陷入困境渐排。

JavaScript代碼整潔之道——好代碼和壞代碼

在本文中,蟲蟲就給大家講講JavaScript代碼的整潔知道灸蟆,全面對(duì)比下好的代碼和壞的代碼的寫法驯耻。

強(qiáng)類型檢查,使用"==="炒考,不用"=="

類型的檢查非常重要可缚,使用強(qiáng)類型檢查可以幫我理清程序邏輯,如果類型檢查松懈了(使用==)斋枢,有可能使你的邏輯"南轅北撤了"帘靡,試看下面的例子:

JavaScript代碼整潔之道——好代碼和壞代碼

所以從現(xiàn)在開始就強(qiáng)類型檢查,"亡羊補(bǔ)牢瓤帚,猶未晚也"描姚!

const value = "520";
if (value === 520) {
console.log(value);
}
//條件不會(huì)滿足。
if (value === "520") {
console.log(value);
}
//條件滿足缘滥。

變量命名

變量的命名要有意義轰胁,而不是隨意亂起。最好是"望文生義"朝扼,一看到變量名就知道是干嘛用的赃阀。

望文生義

壞代碼:

let daysSLV= 10;
let y = new Date().getFullYear();
let ok;
if (user.age > 30) {
ok = true;
}

好代碼:

const MAX_AGE = 30;
let daysSinceLastVisit = 10;
let currentYear = new Date().getFullYear();
...
const isUserOlderThanAllowed = user.age > MAX_AGE;

不要給變量添加額外不需要的單詞

壞代碼:

let nameValue;
let theProduct;

好代碼:

let name;
let product;

不要依賴從上下文才能了解變量的意思

壞代碼:

const ans = ["Chongchong", "maomaochong", "bollworm"];
ans.forEach(an => {
doSomething();
doSomethingElse();
// ...
// 等等,這個(gè)u是干嘛用的擎颖?
register(an);
});

好代碼:

const animals = ["Chongchong", "maomaochong", "bollworm"];
animals.forEach(animal => {
doSomething();
doSomethingElse();
// ...
// ...
register(animal);
});

不添加多余的上下文

壞代碼:

const user = {
userName: "Chongchong",
userNameAbb: "CC",
userAge: "28"
};
...
user.userName;

好代碼:

const user = {
Name: "Chongchong",
NameAbb: "CC",
userAge: "28"
};
...
user.userName;

函數(shù)

使用長(zhǎng)而具有描述性的函數(shù)名榛斯。

由于函數(shù)一般來說表示某種行為,函數(shù)名稱應(yīng)該是動(dòng)詞或短??語搂捧,這樣可以顯示功能以及參數(shù)的意義驮俗。

壞代碼:

function notif(user) {
// 代碼邏輯
}

好代碼:

function notifyUser(emailAddress){
//代碼邏輯
}

避免大量使用參數(shù)。

理想情況下允跑,函數(shù)應(yīng)該指定兩個(gè)或更少的參數(shù)王凑。參數(shù)越少搪柑,函數(shù)單元測(cè)試就越容易。

壞代碼:

function getUsers(fields, fromDate, toDate) {
//代碼邏輯
}

好代碼:

function getUsers({ fields, fromDate, toDate }) {
// 碼邏輯
}
getUsers({
fields: ['name', 'surname', 'email'],
fromDate: '2019-05-22',
toDate: '2019-05-31'
});

使用默認(rèn)參數(shù)索烹,不用條件

壞代碼:

function createShape(type) {
const shapeType = type || "circle";
// ...
}

好代碼:

function createShape(type = "circle") {
// ...
}

一個(gè)函數(shù)做一件事工碾。避免在單個(gè)函數(shù)中執(zhí)行多個(gè)操作,多種邏輯

壞代碼:

function notifyUsers(users) {
users.forEach(user => {
const userRecord = database.lookup(user);
if (userRecord.isVerified()) {
notify(user);
}
});
}

好代碼:

function notifyVerifiedUsers(users) {
users.filter(isUserVerified).forEach(notify);
}
function isUserVerified(user) {
const userRecord = database.lookup(user);
return userRecord.isVerified();
}

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

壞代碼:

const shapeConfig = {
type: "cube",
width: 200,
height: null
};
function createShape(config) {
config.type = config.type || "cube";
config.width = config.width || 250;
config.height = config.width || 250;
}
createShape(shapeConfig);

好代碼:

const shapeConfig = {
type: "cube",
width: 200
};
function createShape(config) {
config = Object.assign(
{
type: "cube",
width: 250,
height: 250
},
config
);
...
}
createShape(shapeConfig);

不要使用標(biāo)志作為參數(shù)。

壞代碼:

function createFile(name, isPublic) {
if (isPublic) {
fs.create(`./public/${name}`);
} else {
fs.create(name);
}
}

好代碼

function createFile(name) {
fs.create(name);
}
function createPublicFile(name) {
createFile(`./public/${name}`);
}

不要讓全局變量/函數(shù)污染

如果需要擴(kuò)展現(xiàn)有對(duì)象百姓,請(qǐng)使用ES類和繼承渊额,不要在對(duì)象原型鏈上創(chuàng)建函數(shù)。

壞代碼:

Array.prototype.myFunc = function myFunc() {
// 代碼邏輯
};

**好代碼:**
class SuperArray extends Array {
myFunc() {
//代碼邏輯
}
}

條件

不要用否定句

壞代碼

function isUserNotBlocked(user) {
//代碼邏輯
}
if (!isUserNotBlocked(user)) {
//代碼邏輯
}

好代碼:

function isUserBlocked(user) {
//代碼邏輯
}
if (isUserBlocked(user)) {
//代碼邏輯
}

使用布爾變量直接判斷垒拢,而不是條件語句

壞代碼:

if (isValid === true) {
//代碼邏輯
}
if (isValid === false) {
//代碼邏輯
}

好代碼:

if (isValid) {
//代碼邏輯
}
if (!isValid) {
//代碼邏輯
}

避免使用條件旬迹,用多態(tài)和繼承。

壞代碼:

class Car {
// ...
getMaximumSpeed() {
switch (this.type) {
case "Ford":
return this.someFactor() + this.anotherFactor();
case "Benz":
return this.someFactor();
case "BYD":
return this.someFactor() - this.anotherFactor();
}
}
}

好代碼:

class Car {
// ...
}
class Ford extends Car {
// ...
getMaximumSpeed() {
return this.someFactor() + this.anotherFactor();
}
}
class Benz extends Car {
// ...
getMaximumSpeed() {
return this.someFactor();
}
}
class BYD extends Car {
// ...
getMaximumSpeed() {
return this.someFactor() - this.anotherFactor();
}
}

ES類

類是JavaScript中的新的語法糖求类。除了語法不同外奔垦,其他都和prototype一樣工作。使用ES類可以讓你的代碼更加簡(jiǎn)潔清晰仑嗅。

壞代碼:

const Person = function(name) {
  if (!(this instanceof Person)) {
    throw new Error("Instantiate Person with `new` keyword");
  }

  this.name = name;
};

Person.prototype.sayHello = function sayHello() { /**/ };

const Student = function(name, school) {
  if (!(this instanceof Student)) {
    throw new Error("Instantiate Student with `new` keyword");
  }

  Person.call(this, name);
  this.school = school;
};

Student.prototype = Object.create(Person.prototype);
Student.prototype.constructor = Student;
Student.prototype.printSchoolName = function printSchoolName() { /**/ };

好代碼:

class Person {
  constructor(name) {
    this.name = name;
  }

  sayHello() {
    /* ... */
  }
}

class Student extends Person {
  constructor(name, school) {
    super(name);
    this.school = school;
  }

  printSchoolName() {
    /* ... */
  }
}

使用方法鏈接

許多庫(kù)如jQuery和Lodash都使用該模式宴倍。因此张症,該方法可以讓的代碼簡(jiǎn)潔仓技。在主類中,只需在每個(gè)函數(shù)的末尾返回"this"俗他,就可以將更多的類方法鏈接到該方法脖捻。

壞代碼:

class Person {
  constructor(name) {
    this.name = name;
  }
  setSurname(surname) {
    this.surname = surname;
  }
  setAge(age) {
    this.age = age;
  }
  save() {
    console.log(this.name, this.surname, this.age);
  }
}
const person = new Person("Chongchong");
person.setSurname("CC");
person.setAge(29);
person.save();

好代碼:

class Person {
  constructor(name) {
    this.name = name;
  }
  setSurname(surname) {
    this.surname = surname;
    return this;
  }
  setAge(age) {
    this.age = age;
    return this;
  }
  save() {
    console.log(this.name, this.surname, this.age);
    return this;
  }
}
const person = new Person("Chongchong")
    .setSurname("CC")
    .setAge(29)
.save();

其他

通常情況下,盡量不要寫不要重復(fù)代碼兆衅,不要寫不使用的函數(shù)和死代碼地沮。

出于歷史原因,可能會(huì)遇到重復(fù)的代碼羡亩。例如摩疑,有兩段你略有不同的代碼,但是有很多共同的邏輯畏铆,為省事或者趕工期雷袋,導(dǎo)致你復(fù)制了大段代碼,略做小改然后使用了辞居。針對(duì)這種代碼楷怒,后期一定要及早抽象出相同邏輯部分刪除重復(fù)代碼越早越好,不要欠死賬瓦灶,不然后越積越多就不好處理了鸠删。

關(guān)于死代碼,碼如其名贼陶。就是啥事不干刃泡,刪了可能引入錯(cuò)誤巧娱,這和上面的一樣處理,及早處理烘贴,不用了就早處理家卖,早刪除。

結(jié)論

上面只是代碼整潔的部分原理庙楚,而且個(gè)別條款也可能需要商榷上荡。這些大部分理論來源于《代碼整潔之道》這本書。有什么建議意見請(qǐng)回復(fù)馒闷,一起學(xué)習(xí)討論酪捡。

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個(gè)濱河市纳账,隨后出現(xiàn)的幾起案子逛薇,更是在濱河造成了極大的恐慌,老刑警劉巖疏虫,帶你破解...
    沈念sama閱讀 216,470評(píng)論 6 501
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件永罚,死亡現(xiàn)場(chǎng)離奇詭異,居然都是意外死亡卧秘,警方通過查閱死者的電腦和手機(jī)呢袱,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 92,393評(píng)論 3 392
  • 文/潘曉璐 我一進(jìn)店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來翅敌,“玉大人羞福,你說我怎么就攤上這事◎卿蹋” “怎么了治专?”我有些...
    開封第一講書人閱讀 162,577評(píng)論 0 353
  • 文/不壞的土叔 我叫張陵,是天一觀的道長(zhǎng)遭顶。 經(jīng)常有香客問我张峰,道長(zhǎng),這世上最難降的妖魔是什么棒旗? 我笑而不...
    開封第一講書人閱讀 58,176評(píng)論 1 292
  • 正文 為了忘掉前任喘批,我火速辦了婚禮,結(jié)果婚禮上嗦哆,老公的妹妹穿的比我還像新娘谤祖。我一直安慰自己,他們只是感情好老速,可當(dāng)我...
    茶點(diǎn)故事閱讀 67,189評(píng)論 6 388
  • 文/花漫 我一把揭開白布粥喜。 她就那樣靜靜地躺著,像睡著了一般橘券。 火紅的嫁衣襯著肌膚如雪额湘。 梳的紋絲不亂的頭發(fā)上卿吐,一...
    開封第一講書人閱讀 51,155評(píng)論 1 299
  • 那天,我揣著相機(jī)與錄音锋华,去河邊找鬼嗡官。 笑死,一個(gè)胖子當(dāng)著我的面吹牛毯焕,可吹牛的內(nèi)容都是我干的衍腥。 我是一名探鬼主播,決...
    沈念sama閱讀 40,041評(píng)論 3 418
  • 文/蒼蘭香墨 我猛地睜開眼纳猫,長(zhǎng)吁一口氣:“原來是場(chǎng)噩夢(mèng)啊……” “哼婆咸!你這毒婦竟也來了?” 一聲冷哼從身側(cè)響起芜辕,我...
    開封第一講書人閱讀 38,903評(píng)論 0 274
  • 序言:老撾萬榮一對(duì)情侶失蹤尚骄,失蹤者是張志新(化名)和其女友劉穎,沒想到半個(gè)月后,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 45,319評(píng)論 1 310
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡郊酒,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 37,539評(píng)論 2 332
  • 正文 我和宋清朗相戀三年,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了需五。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點(diǎn)故事閱讀 39,703評(píng)論 1 348
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡诗舰,死狀恐怖警儒,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情眶根,我是刑警寧澤,帶...
    沈念sama閱讀 35,417評(píng)論 5 343
  • 正文 年R本政府宣布边琉,位于F島的核電站属百,受9級(jí)特大地震影響,放射性物質(zhì)發(fā)生泄漏变姨。R本人自食惡果不足惜族扰,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 41,013評(píng)論 3 325
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望定欧。 院中可真熱鬧渔呵,春花似錦、人聲如沸砍鸠。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,664評(píng)論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽(yáng)爷辱。三九已至录豺,卻和暖如春朦肘,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背双饥。 一陣腳步聲響...
    開封第一講書人閱讀 32,818評(píng)論 1 269
  • 我被黑心中介騙來泰國(guó)打工媒抠, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留,地道東北人咏花。 一個(gè)月前我還...
    沈念sama閱讀 47,711評(píng)論 2 368
  • 正文 我出身青樓趴生,卻偏偏與公主長(zhǎng)得像,于是被迫代替她去往敵國(guó)和親昏翰。 傳聞我的和親對(duì)象是個(gè)殘疾皇子冲秽,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 44,601評(píng)論 2 353

推薦閱讀更多精彩內(nèi)容

  • 一、整潔代碼 A.混亂的代價(jià) 1.有些團(tuán)隊(duì)在項(xiàng)目初期進(jìn)展迅速矩父,但有那么一兩年的時(shí)間卻慢去蝸行锉桑。對(duì)代碼的每次修改都影...
    ZyBlog閱讀 2,036評(píng)論 0 2
  • 代碼整潔之道 Clean Code 第一章 整潔代碼 代碼的重要性我們永遠(yuǎn)拋不掉代碼,因?yàn)榇a呈現(xiàn)了需求的細(xì)節(jié)窍株。在...
    Pengzh1閱讀 1,213評(píng)論 0 1
  • 目錄及筆記鏈接 序 丹麥諺語:小處誠(chéng)實(shí)非小事民轴。 建筑師路德維希:神在細(xì)節(jié)之中。 日本的 5S 哲學(xué): 整理(整理球订、...
    小鐳Ra閱讀 1,496評(píng)論 3 3
  • 函數(shù)和對(duì)象 1后裸、函數(shù) 1.1 函數(shù)概述 函數(shù)對(duì)于任何一門語言來說都是核心的概念。通過函數(shù)可以封裝任意多條語句冒滩,而且...
    道無虛閱讀 4,556評(píng)論 0 5
  • 整潔代碼 Leblanc : Later equals never.(勒布朗法則:稍后等于永不) 對(duì)代碼的每次修改...
    foever_f1eb閱讀 806評(píng)論 0 0