首页 > 代码库 > node.js编程规范

node.js编程规范

B.1缩进

因为Node.js代码中很容易写出深层的函数嵌套,过多的空格会给阅读带来不便,因此我们选择两空格缩进

B.2行宽

为了保证在任何设备上都可以方便地阅读,我们建议把行宽限制为80个字符。

B.3 语句分隔符

建议一律使用分号( ; ),哪怕一行只有一个语句,也不要省略分号。

B.4 变量定义

永远使用var 定义变量,而不要通过赋值隐式定义变量。因为通过赋值隐式定义的变量总是全局变量,会造成命名空间污染。

使用var 定义变量时,确保每个语句定义一个变量,而不要通过逗号( , )把多个变量隔开。

B.5 变量名和属性名

我们使用小驼峰式命名法(lower camel case)作为所有变量和属性的命名规则,不建议使用任何单字母的变量名。

varyourName = ‘BYVoid‘; 

B.6函数

对于一般的函数我们同样使用小驼峰式命名法。但对于对象的构造函数名称(或者不严格地说“类”的名称),我们使用大驼峰式命名法(upper camel case),也称为Pascal命名法

var someFunction = function (){  return ‘something‘;};function anotherFunction() {  return ‘anything‘;}function DataStructure() {  this.someProperty = ‘initialized‘;}

B.7引号

JavaScript中单引号( ‘ )和双引号( " )没有任何语义区别,两者都是可用的。我们建议一律统一为单引号,因为JSON、XML都规定了必须是双引号,这样便于无转义地直接引用。

B.8 关联数组的初始化

将var = { 放在一行,下面每行一对键值,保持两空格的缩进,以分号结尾,}; 最后单独另起一行。对于每对键值,除非键名之中有空格或者有非法字符,否则一律不用引号。

B.9等号

尽量使用=== 而不是== 来判断相等,因为== 包含了隐式类型转换

B.10 命名函数

尽量给构造函数和回调函数命名,这样当你在调试的时候可以看见更清晰的调用栈。

对于回调函数,Node.js的API和各个第三方的模块通常约定回调函数的第一个参数是错误对象err,如果没有错误发生,其值为undefined。

B.11 对象定义

尽量将所有的成员函数通过原型定义,将属性在构造函数内定义,然后对构造函数使用new 关键字创建对象。绝对不要把属性作为原型定义,因为当要定义的属性是一个对象的时候,不同实例中的属性会指向同一地址。除非必须,避免把成员函数定义在构造函数内部,否则会有运行时的闭包开销。

//错误:function FooObj(bar) {  this.bar = bar;  this.func = function ()  {    console.log(this.arr);  };}FooObj.prototype.arr = [1, 2, 3];var obj1 = newFooObj(‘obj1‘);var obj2 = newFooObj(‘obj2‘);obj1.arr.push(4);obj1.func(); // [1, 2, 3, 4] obj2.func(); // [1, 2, 3, 4] 

B.12继承

首先,避免使用复杂的继承,如多重继承或深层次的继承树。如果的确需要继承,那么尽量使用Node.js的util模块中提供的inherits函数。