正确的JavaScript编程风格

Douglas Crockford是JavaScript权威,Json格式就是他的发明。去年11月他有一个演讲(Youtube),谈到了好的JavaScript编程风格是什么。

我非常推荐这个演讲,它不仅有助于学习JavaScript,而且能让你心情舒畅,因为Crockford讲得很幽默,时不时让听众会心一笑。

下面,我根据这个演讲和Crockford编写的代码规范,总结一下“JavaScript编程风格”。

所谓“编程风格”(programming style),指的是编写代码的样式规则。不同的程序员,往往有不同的编程风格。

有人说,编译器的规范叫做“语法规则”(grammar),这是程序员必须遵守的;而编译器忽略的部分,就叫“编程风格”(programming style),这是程序员可以自由选择的。这种说法不完全正确,程序员固然可以自由选择编程风格,但是好的编程风格有助于写出质量更高、错误更少、更易于维护的程序。

所以,有一点应该明确,”编程风格”的选择不应该基于个人爱好、熟悉程度、打字工作量等因素,而要考虑如何尽量使代码清晰易读、减少出错。你选择的,不是你喜欢的风格,而是一种能够清晰表达你的意图的风格。这一点,对于JavaScript这种语法自由度很高、设计不完全成熟的语言尤其重要。

一、大括号的位置

绝大多数的编程语言,都用大括号({})表示区块(block)。起首的大括号的位置,有许多不同的写法

最流行的有两种。一种是起首的大括号另起一行:

  1. block
  2. {
  3. }

另一种是起首的大括号跟在关键字的后面:

  1. block {
  2. }

一般来说,这两种写法都可以接受。但是,JavaScript要使用后一种,因为JavaScript会自动添加句末的分号,导致一些难以察觉的错误。

  1. return
  2. {
  3. key:value;
  4. };

上面的代码的原意,是要返回一个对象,但实际上返回的是undefined,因为JavaScript自动在return语句后面添加了分号。为了避免这一类错误,需要写成下面这样:

  1. return {
  2. key : value;
  3. };

因此,

规则1:表示区块起首的大括号,不要另起一行。

二、圆括号

圆括号(parentheses)在JavaScript中有两种作用,一种表示调用函数,另一种表示不同的值的组合(grouping)。我们可以用空格,区分这两种不同的括号。

规则2:调用函数的时候,函数名与左括号之间没有空格。

规则3:函数名与参数序列之间,没有空格。

规则4:所有其他语法元素与左括号之间,都有一个空格。

按照上面的规则,下面的写法都是不规范的:

  1. foo (bar)
  2. return (a+b);
  3. if (a === 0) {…}
  4. function foo (b) {…}
  5. function (x) {…}

三、分号

分号表示语句的结束。大多数情况下,如果你省略了句尾的分号,JavaScript会自动添加。

var a = 1

等同于

var a = 1;

因此,有人提倡省略句尾的分号。但麻烦的是,如果下一行的第一个字元(token)是下面这五个字符之一,JavaScript将不对上一行句尾添加分号:”(“、”[“、”/”、”+”和”-“。

  1. x = y
  2. (function (){
  3. })();

上面的代码等同于

x = y (function (){…})();

因此,

规则5:不要省略句末的分号。

四、with语句

with可以减少代码的书写,但是会造成混淆。

  1. with (o) {
  2. foo = bar;
  3. }

上面的代码,可以有四种运行结果:

  1. o.foo = bar;
  2. oo.foo = o.bar;
  3. foo = bar;
  4. foo = o.bar;

这四种结果都可能发生,取决于不同的变量是否有定义。因此,

规则6:不要使用with语句。

五、相等和严格相等

JavaScript有两个表示”相等”的运算符:”相等”(==)和”严格相等”(===)。

因为”相等”运算符会自动转换变量类型,造成很多意想不到的情况:

  1. 0 == ”// true
  2. 1 == true // true
  3. 2 == true // false
  4. 0 == ‘0’ // true
  5. false == ‘false’ // false
  6. false == ‘0’ // true
  7. ” trn ” == 0 // true

因此,

规则7:不要使用”相等”(==)运算符,只使用”严格相等”(===)运算符。

六、语句的合并

有些程序员追求简洁,喜欢合并不同目的的语句。比如,原来的语句是

a = b;

if (a) {…}

他喜欢写成下面这样:

if (a = b) {…}

虽然语句少了一行,但是可读性大打折扣,而且会造成误读,让别人误以为这行代码的意思是:

if (a === b){…}

另外一种情况是,有些程序员喜欢在同一行中赋值多个变量:

var a = b = 0;

他以为,这行代码等同于

var a = 0, b = 0;

实际上不是,它的真正效果是下面这样:

b = 0;

var a = b;

因此,

规则8:不要将不同目的的语句,合并成一行。

七、变量声明

JavaScript会自动将变量声明”提升”(hoist)到代码块(block)的头部。

  1. if (!o) {
  2. var o = {};
  3. }

等同于

  1. var o;
  2. if (!o) {
  3. o = {};
  4. }

为了避免可能出现的问题,不如把变量声明都放在代码块的头部。

for (var i …) {…}

最好写成:

var i;

for (i …) {…,}

因此,

规则9:所有变量声明都放在函数的头部。

规则10:所有函数都在使用之前定义。

八、全局变量

JavaScript最大的语法缺点,可能就是全局变量对于任何一个代码块,都是可读可写。这对代码的模块化和重复使用,非常不利。

规则11:避免使用全局变量;如果不得不使用,用大写字母表示变量名,比如UPPER_CASE。

九、new命令

JavaScript使用new命令,从建构函数生成一个新对象。

var o = new myObject ();

这种做法的问题是,一旦你忘了加上 new,myObject ()内部的this关键字就会指向全局对象,导致所有绑定在this上面的变量,都变成全部变量。

规则12:不要使用new命令,改用Object.create()命令。

如果不得不使用new,为了防止出错,最好在视觉上把建构函数与其他函数区分开来。

规则13:建构函数的函数名,采用首字母大写(InitialCap);其他函数名,一律首字母小写。

十、自增和自减运算符

自增(++)和自减(–)运算符,放在变量的前面或后面,返回的值不一样,很容易发生错误。

事实上,所有的++运算符都可以用”+= 1″代替。

++x

等同于

x += 1;

代码变得更清晰了。有一个很可笑的例子,某个JavaScript函数库的源代码中出现了下面的片段:

++x;

++x;

这个程序员忘了,还有更简单、更合理的写法:

x += 2;

因此,

规则14:不要使用自增(++)和自减(–)运算符,用+=和-=代替。

十一、区块

如果循环和判断的代码体只有一行,JavaScript允许该区块(block)省略大括号。

下面的代码

if (a) b (); c ();

原意可能是

if (a) { b (); c ();}

但是,实际效果是

if (a) { b ();} c ();

因此,

规则15:总是使用大括号表示区块。