变量

• 局部变量命名采用首字母小写，其它单词首字母大写：

//推荐

var printContent = 'hello world'

//不推荐，变量名意义不明确

var objext = {};

//不推荐，变量名以类型最为前缀

var strName = 'Hello World'

//不推荐，变量名使用语义不明确的缩写

var newAC = functiono(){}

接口

• 公有接口：首字母大写
• 私有接口：首字母小写

Reader.Content = function () {

    //私有变量

    var info, title;

    //私有方法

    var getContent = function () { };

    return {

        //公有属性

        ContentInfo: info,

        //公有方法

        SetTitle: function (contentTitle) {

            title = contentTitle;

        }

    }

}

jQuery框架

• jQuery类型变量添加 $ 最为前缀

var $tocTitle = $('.reader-toc-title');

空格

• 函数参数逗号,后面加空格
• 函数名后面不加空格
• 参数)和{之间有空格

function Partition(data, length, start, end) {

}

• for 循环中的;后面加空格

for (var i = 0; i < 10; i++)

• = < 等操作符前后加空格

while (x == y)

• for while 等后面加空格

注释

• 单行注释 //，单独占一行，不要写在代码后面
• 多行注释/* */

/* 文件头部信息注释 */

/*!

 * reader content v1.0

 *

 * Copyright 2018

*/

其它

• 字符串使用单引号，因为HTML中使用双引号

var content = '<sapn id="main_content"> ...';

• 左大括号不要另起一行，

for(var i = 0; i < 10; i ++){

}

• 即使逻辑只有一行也要用大括号括起来

if(false){

  return true;

}

• 语句结束时添加分号;
• JavaScript有自动插入分号的算法，但是有缺陷

在没有添加分号的语句结束处自动添加分号

除非下一行以[、(、+、-、/开头则不添加分号

• 由于自动添加分号导致错误

return

{

  a + b

}

等价于

return ;

{

  a + b

}

可以通过将(不另起一行解决

• 由于没有在该添加分号处添加导致错误

var b = function()

var a = b

(function()

)()

等价于

var a = b(function())()

---

参考： 《Web前端开发最佳实践》