JavaScript 编码风格指南

//  4个空格的层级缩进
if (true) {
    doSomething();
}

//  每行限于80个字符，超出则在运算符后换行，缩进2个层级（8个空格）
doSomething(argument1, argument2, argument3, argument4,
        argument5);

//  字符串使用双引号及长字符串的链接
var name = "Nicholas",
    longStr = "this is a long string you should " +
              "change another line.";

//  数字
var count = 10,
    price = 10.50,
    num = 1e10;

//  null,表示或期望是对象
var person = null;
 
function getPerson () {
    if (condition) {
        return new Person("Nicholas");
    } else {
        return null;
    }
}

//  undefined  变量声明而未赋值的状态，避免使用；
var variable = undefined   //  dont do this

if (typeof variable === "undefined") {
    //  do like this
}

//  运算符前后使用一个空格来保持表达式的整洁
var found = (value[i] === item);

if (found && (count > 10)) {
    doSomething();
}

for (i = 0; i < count; i++) {
    process(i);
}

//  层级缩进、语段前后空行、函数前后空行、属性不加引号、冒号紧跟其后
var object = {
    key1: value1,
    key2: value2,

    func: function () {
        // a function to do something
    },

    key3: value3
}

//  单行注释1
if (condition) {
    
    //  如果代码执行到这里，表明通过了安全检查
    doSomething();
}

//  单行注释2
var result = result1 + result2;  //  result1, result2应当是整数

//  多行注释
function getResult (arg1, arg2) {

    /*
     *  @para arg1
     *  @para arg2
     */
    doSomething();
}

//  整齐、未初始化变量放最后
var count = 10,
    name = "Nicholas",
    found = false,
    empty;

//  标准式，函数名和开始圆括号前不要有空格
function sum(arg1, arg2) {
    return arg1 + arg2;
}

//  道格拉斯推荐式（变量引用式）
var sum = function(arg1, arg2) {
    return arg1 + arg2;
};

//  立即调用式
var value= (function() {
    
    //  函数体

    return {
        message: "Hi"
    }; 
}());

// 普通变量用小驼峰命名法，不要使用下划线，不要用动词开头
var accountNumber = "8341";

//  函数命名用动词开头表意
function getPerson() {
    // return a person object
}

// 构造函数用名词开头且首字母大写
function Person(name) {
    this.name = name;
}

// 常量
var TOTAL_COUNT = 10;

// 私有变量
var object = {
    _count: 10,

    getCount: function() {
        return this._count;
    }
};

// 通过相等判断赋予布尔值
var flag = (a === b);

// 三元操作符应当仅仅用在条件赋值语句中
var value = (condition ? value1 : value2);

// dont do like this, do it use if instead
condition ? doSomething() : doSomethingElse();

// if
if (condition) {
    statements
}

// for
var i, len;
for (i = 0, len = 10; i < len; i++) {
    // code
}

var prop;
for (prop in object) {

    if (object.hasOwnProperty(prop)) {
        // code
    }
}

// while
while (condition) {
    statements
}

// switch
switch (value) {
    case 1:
        statements;
        break;

    case 2:  // falls through
    case 3:
        statements;
        break;

    // no default
}

(function() {
    "use strict";

    //  code
}());