前言
在实际工作中,我们应该经常会看到一些功能上没有问题,但编码风格和规范却十分糟糕的代码,这往往会让人不敢再往下阅读,甚至会影响阅读者一天的心情。这些代码不仅不易阅读,而且难以维护,它们一般会出自刚入门的编程新手,也会出自工作了好几年的老程序员手下。因此本文的目的在于帮助那些没有养成良好的编码风格,缺乏相应编码规范意识的JavaScript学习者们改善他们的编码形象。
编码形象
以上我提出了编码形象的概念,我个人认为:
编码形象 = 编码风格 + 编码规范
一个良好的编码形象就等于一个穿着得体的青年,对于程序员来说这是同行了解你优秀能力的最直接最简单的方式。
我们来看一下一段糟糕的编码形象:
//打个招呼 function func(){ var age=18,sex='man'; var greeting='hello'; if(age<=18&&sex=='man'){ console.log(greeting+'little boy') } ... } func()
上方代码整体缩在了一起,缺乏规范意识,阅读体验很差,不忍直视。
再来看一段良好的代码形象:
// 打个招呼 function greetFn() { var age = 18, sex = 'man', greeting = 'hello'; if (age <= 18 && sex === 'man') { console.log(greeting + 'little boy'); } ... }; greetFn();
上方的代码是不是感觉舒服多了?
由此可见养成一个良好的编码形象是至关重要的,而本文主要讲解的是基于JavaScript的编码形象,即基于JavaScript的编码风格和编码规范。
那么什么是编码风格,什么是编码规范,两者的区别又是什么?
编码风格
首先编码风格既然是风格,就没有对错之分。就好比每个人的穿着打扮不同,有的人穿的比较得体,有的人穿的比较随意而已。
而在JavaScript编码风格中,也有一套比较得体的风格,尤其在团队开发中,我们不能随意的书写属于自己的风格。
下面就列举几种随意的编码风格,并将其与良好的编码风格进行对比。
1.合理注释
// 不推荐的写法 var name = '劳卜';//代码和注释之间没有间隔 if (name) { /* *注释之前无空行 *星号后面无空格 */ }
// 推荐的写法 var name = '劳卜'; // 代码和注释之间有间隔 if (name) { /* * 注释之前有空行 * 星号后面有空格 */ }
2.合理间隔
// 不推荐的写法 var name='劳卜'; // 等号和两侧之间没有间隔 // if块级语句间没有间隔 if(name){ console.log('hello'); }
// 推荐的写法 var name = '劳卜'; // 等号和两侧之间有间隔 // if块级语句间有间隔 if (name) { console.log('hello'); }
3.合理缩进
// 不推荐的写法:没有合理缩进 function getName() { console.log('劳卜'); }
// 推荐的写法:合理缩进 function getName() { console.log('劳卜'); }
4.合理空行
// 不推荐的写法: 代码功能块之间没有空行 function getName() { var name = '劳卜'; if (name) { console.log('hello'); } }
// 推荐的写法:代码功能块之间有空行 function getName() { var name = '劳卜'; if (name) { console.log('hello'); } }
5.合理命名
// 不推荐的写法 var getName = '劳卜'; // 变量命名前缀为动词 // 函数命名前缀为名词 function name() { console.log('hello'); }
// 推荐的写法 var name = '劳卜'; // 变量命名前缀为名词 // 函数命名前缀为动词 function getName() { console.log('hello'); }
6.合理声明
// 不推荐的写法:函数在声明之前使用 getName(); function getName() { console.log('hello'); }
// 推荐的写法:函数在声明之后使用 function getName() { console.log('hello'); } getName();
7.合理结尾
// 不推荐的写法:没有使用分号结尾 var name = '劳卜' var getName = function() { console.log('hello') }
// 推荐的写法:使用分号结尾 var name = '劳卜'; var getName = function() { console.log('hello'); };
以上主要列举了7个比较常见的编码风格的例子进行了比较,在推荐的写法和不推荐的写法中两者并没有对错之分,只是推荐的写法相比较而言更容易阅读和维护,更适用于团队开发,也是良好编码形象的体现。
编码规范
对于编码规范,既然是规范,那我们就应该按照一定的规则来编写。随意编写违反编码规范的代码,可能会导致程序的出错和潜在的bug,因此其相对于编码风格来说应该更加严谨,也有人会把编码风格包含在编码规范之中。
下面就列举几个常见的实例代码:
1.比较参数
// 不推荐的写法:==和!=比较时会进行类型转换,应尽量避免使用 var num = 123; if (num == '123') { console.log(num); } else if (num != '321') { console.log('321'); }
// 推荐的写法:使用===和!==来进行比较 var num = 123; if (num === '123') { console.log(num); } else if (num !== '321') { console.log('321'); }
2.包裹if语句
// 不推荐的写法:if语句不用大话号包裹会出现潜在bug var num = 123; if (num === '123') console.log(num);
// 推荐的写法:if语句用大话号包裹 var num = 123; if (num === '123') { console.log(num); }
3.慎用eval
// 不推荐的写法:应避免使用eval,不安全,非常耗性能(一次解析成js语句,一次执行) var json = '{"name": "劳卜", "func": alert("hello")}'; eval('(' + json + ')'); // 弹出“hello”
// 推荐的写法 var json = '{"name": "劳卜", "func": alert("hello")}'; JSON.parse(json); // 校验报错
4.判断类型
// 不推荐的写法:用typeof来判断构造函数创建的对象 var str = new String('劳卜'); console.log(typeof str); // 'object'
// 推荐的写法:用instanceof来判断构造函数创建的对象 var str = new String('劳卜'); console.log(str instanceof String); // true
5.检测属性
// 不推荐的写法:使用undefined和null来检测一个属性是否存在 if (obj['name'] !== undefined) { console.log('name属性存在'); // 若obj.name为undefined时则会导致判断出错 } if (obj['name'] !== null) { console.log('name属性存在'); // 若obj.name为null时则会导致判断出错 }
// 推荐的写法:使用in运算符来检测对象属性是否存在,使用hasOwnProperty方法来检测不包含原型链上的对象属性是否存在 if ('name' in obj) { console.log('name属性存在'); } if (obj.hasOwnProperty('name')) { console.log('name属性存在'); }
以上主要列举了5个常见的编码规范的例子,合理地规范自己的代码能够很大程度上减少不必要的维护成本和潜在的bug风险,对于JavaScript学习者来说应该铭记于心。
结语
“程序是写给人读的,只是偶尔让计算机执行一下。”我们不能为了贪图一时的方便而亲手毁了自己的代码形象,这会给他人和整个项目带来不必要的麻烦。
以上就是本文的全部内容,希望本文的内容对大家的学习或者工作能带来一定的帮助,同时也希望多多支持!
P70系列延期,华为新旗舰将在下月发布
3月20日消息,近期博主@数码闲聊站 透露,原定三月份发布的华为新旗舰P70系列延期发布,预计4月份上市。
而博主@定焦数码 爆料,华为的P70系列在定位上已经超过了Mate60,成为了重要的旗舰系列之一。它肩负着重返影像领域顶尖的使命。那么这次P70会带来哪些令人惊艳的创新呢?
根据目前爆料的消息来看,华为P70系列将推出三个版本,其中P70和P70 Pro采用了三角形的摄像头模组设计,而P70 Art则采用了与上一代P60 Art相似的不规则形状设计。这样的外观是否好看见仁见智,但辨识度绝对拉满。
更新动态
- 梅艳芳.1994-是这样的(金碟版)【华星】【WAV+CUE】
- 张学友《真情流露》HQ+S纯银深度[低速原抓WAV+CUE]
- 江志丰2012-七天[豪记][WAV+CUE]
- 黑鸭子2003《聆听柔情HQCD》[日本版][WAV+CUE]
- 群星《奔赴!万人现场 第5期》[FLAC/分轨][587.07MB]
- 关大洲《国家宝藏 第四季原声音乐 关大洲作品》[320K/MP3][109.49MB]
- 关大洲《国家宝藏 第四季原声音乐 关大洲作品》[FLAC/分轨][527.23MB]
- LOL双城之战大乱斗什么时候更新 双城大乱斗上线更新时间介绍
- s14全球总决赛冠军皮肤有什么 2024T1冠军皮肤选择一览
- faker加里奥s14决赛什么出装 faker加里奥s14决赛出装介绍
- 《马里奥与路易吉RPG:兄弟齐航》Fami通34分:路易吉存在感拉满
- 数据挖掘者新发现:NS继任机型或支持4K分辨率
- 宫本茂谈任天堂未来:研发费用增加但注重创意与传承
- 陈小云.2000-餐厅综艺金榜【海丽唱片】【WAV+CUE】
- 卓文萱.2008-翻滚吧!蛋炒饭电视原声带【滚石】【FLAC分轨】