日期:2014-05-16  浏览次数:20386 次

JavaScript 开发规范

原文来自淘宝前端开饭规范:http://kissyteam.github.com/docs/html/styleguide/js-style-rules.html

?

行与缩进

语句行

  1. 尽可能不要让每行超过 120 个字符;
  2. 语句必须以分号作为结束符, 不要忽略分号;

空格

  1. 数值操作符(如,?+/-/*/% ?等)两边留空;
  2. 赋值操作符/等价判断符两边留一空格;
  3. for 循环条件中, 分号后留一空格;
  4. 变量声明语句, 数组值, 对象值及函数参数值中的逗号后留一空格;
  5. 空行不要有空格;
  6. 行尾不要有空格;
  7. 逗号和冒号后一定要跟空格;
  8. 点号前后不要出现空格;
  9. 空对象和数组不需要填入空格;
  10. 函数名末尾和左括号之间不要出现空格;

空行

  1. 逻辑上独立的代码块使用空行分隔;
  2. 文件末尾留?1~2 ?个空行;
  3. 不要吝啬空行。尽量使用空行将逻辑相关的代码块分割开,以提高程序的可读性。

缩进

  1. 以 4 个空格为一缩进层次;

  2. 变量声明:

    • 多个变量声明时, 适当换行表示;
    • 参照?var ?关键字, 缩进一层次;
  3. 函数参数:

    • 函数参数写在同一行上;
    • 传递匿名函数时, 函数体应从调用该函数的左边开始缩进;
  4. 数组和对象初始化时:

    • 如果初始值不是很长, 尽量保持写在单行上;
    • 初始值占用多行时, 缩进一层次;
    • 对象中, 比较长的变量/数值, 不要以冒号对齐;
  5. 二元/三元操作符:

    • 操作符始终跟随前行;
    • 实在需要缩进时, 按照上述缩进风格;
  6. 表达式中的缩进同变量声明时;

括号

原则: 不要滥用括号, 必要时一定要使用.