不管有多少人共同参与同一项目,一定要确保每一行代码都像是同一个人编写的

命名规则

项目命名

全部采用 小写 方式,以 下划线 分隔
例:my_project_name

目录命名

  1. 参照项目命名规则
  2. 有复数结构时,采用复数命名法

例: scripts、styles、images、data_modals

JS文件命名

参照项目命名规则
例: lk_utils.js

CSS,SCSS文件命名

参照项目命名规则
例:lk_style.scss

HTML文件命名

参照项目命名规则
例:lk_index.html


HTML


语法

  1. 缩进使用2个空格(bootstrap规范)
  2. 嵌套的节点应该缩进标签不要大写,即便是 doctype 标签
  3. 在属性上,使用双引号,不要使用单引号
  4. 属性名全小写,用中划线做分隔符
  5. 不要在自动闭合标签结尾处使用斜线(HTML5 规范 指出他们是可选的)
  6. 不要忽略可选的关闭标签,例: </li></body>
    1. <!doctype html>
    2. <html>
    3. <head>
    4. <title>Page title</title>
    5. </head>
    6. <body>
    7. <img src="images/company_logo.png" alt="Company">
    8. <h1 class="hello-world">Hello, world!</h1>
    9. </body>
    10. </html>

    HTML doctype

    为每个 HTML 页面的第一行添加standards mode(标准模式)声明,这样能够确保在每个浏览器中拥有一致的展现

lang属性

根据HTML5规范:

应在html标签上加上lang属性,从而为文档设置正确的语言。这会给语音工具和翻译工具帮助,告诉它们应当怎么去发音和翻译。

更多关于 lang 属性的说明在这里
在菜鸟联盟上可以查到语言列表

charset 字符编码

通过声明一个明确的字符编码,让浏览器轻松、快速的确定适合网页内容的渲染方式,通常指定为‘UTF-8’

IE兼容模式

  1. 标签可以指定页面应该用什么版本的IE来渲染

如果想要了解更多,请点击这里

What does do? Depending upon what Microsoft browsers you support you may not need to continue using the X-UA-Compatible tag. If you need to support IE9 or IE8, then I would recommend using the tag. If you only support the latest browsers (IE11 and/or Edge) then I would consider dropping this tag altogether.

简而言之需要兼容IE9/8,加上X-UA-Compatible,否则不用加

  1. 不同doctype在不同浏览器下会触发不同的渲染模式(这篇文章总结的很到位) ```html <!DOCTYPE html>
  1. <a name="hH7vP"></a>
  2. ## 引入CSS,JS
  3. 根据html5规范,通常在引入CSS和JS时不需要指明type,因为 `text/css`和 `text/javasctipt` 分别是他们的默认值
  4. <a name="HTML5"></a>
  5. ### HTML5规范链接
  6. - [使用link](http://www.w3.org/TR/2011/WD-html5-20110525/semantics.html#the-link-element)
  7. - [使用style](http://www.w3.org/TR/2011/WD-html5-20110525/semantics.html#the-style-element)
  8. - [使用script](http://www.w3.org/TR/2011/WD-html5-20110525/scripting-1.html#the-script-element)
  9. ```html
  10. <!-- External CSS -->
  11. <link rel="stylesheet" href="code_guide.css">
  12. <!-- In-document CSS -->
  13. <style>
  14. ...
  15. </style>
  16. <!-- External JS -->
  17. <script src="code_guide.js"></script>
  18. <!-- In-document JS -->
  19. <script>
  20. ...
  21. </script>

属性顺序

属性应该按照特定的顺序出现以保证易读性

  • class
  • id
  • name
  • data-*
  • src , for , type , href , value , max-length , max , min , pattern
  • placeholder , title , alt
  • aria-* , role
  • required , readonly , disabled

class是为高可复用组件设计的,所以应处在第一位
id更加具体且应该尽量少使用,所以将它放在第二位

<a class="..." id="..." data-modal="toggle" href="#">Example link</a>

<input class="form-control" type="text">

<img src="..." alt="...">

boolean属性

boolean属性指不需要声明取值的属性,XHTML需要每个属性声明取值,但是HTML5中并不需要

boolean属性的存在表示取值为true,不存在则表示取值为false。

<input type="text" disabled>

<input type="checkbox" value="1" checked>

<select>
    <option value="1" selected>1</option>
</select>

JS中生成标签

在JS文件中生成标签让内容变得更难查找,更难编辑,性能更差。应该尽量避免这种情况的出现。

减少标签数量

  1. 在编写HTML代码时,需要尽量避免多余的父节点
  2. 很多时候, 需要通过迭代和重构来使HTML变得更少 ```html 前端 Code Guide - 图1

前端 Code Guide - 图2


<a name="UchNf"></a>
## 实用高于完美

1. 尽量遵循HTML标准和语义
1. 任何时候都要用 `尽量小的复杂度` 和 `尽量少的标签` 来解决问题
1. 但是不应该以浪费实用性作为代价

---


<a name="3GG21"></a>
# CSS,SCSS

<a name="hIxLS"></a>
## 通识
```css
/* 这样叫规则(下同) */
.element {
  ...
}

.element {
  /* 这样叫属性(下同) */
  height: 30px;
}

缩进

使用2空格

分号

每个属性声明末尾都要加分号

空格

以下几种情况不需要空格:

  • 每条声明语句的 :
  • 多个规则的分隔符 " .
  • !important !
  • 属性值中 ( ) 的前后
  • 行末不要有多余的空格

以下几种情况需要空格:

  • 属性值前
  • 选择器 > , + , ~ 前后
  • {
  • !important !
  • @else 前后
  • 属性值中的 ,
  • 注释 /* 后和 _*/_
/* not good */
.element {
    color :red! important;
    background-color: rgba(0,0,0,.5);
}

/* good */
.element {
    color: red !important;
    background-color: rgba(0, 0, 0, .5);
}

/* not good */
.element ,
.dialog{
    ...
}

/* good */
.element,
.dialog {

}

/* not good */
.element>.dialog{
    ...
}

/* good */
.element > .dialog{
    ...
}

/* not good */
.element{
    ...
}

/* good */
.element {
    ...
}

/* not good */
@if{
    ...
}@else{
    ...
}

/* good */
@if {
    ...
} @else {
    ...
}

空行

以下几种情况需要空行:

  • 文件最后保留一个空行
  • } 后最好跟一个空行,包括SCSS中嵌套的规则
  • 属性组之间需要适当的空行,详见下方的 属性顺序 ```css / not good / .element { … } .dialog { color: red; &:after {
      ...
    
    } }

/ good / .element { … }

.dialog { color: red;

&:after {
    ...
}

}


<a name="jPZZt"></a>
## 换行
以下几种情况不需要换行:

- `{` 前

以下几种情况需要换行:

- `{` 后和 `}` 前
- 每个属性独占一行
- 多个规则的分隔符 `,` 后
```css
/* not good */
.element
{color: red; background-color: black;}

/* good */
.element {
    color: red;
    background-color: black;
}

/* not good */
.element, .dialog {
    ...
}

/* good */
.element,
.dialog {
    ...
}

注释

  1. 注释统一用 /* */ (SCSS中也不要用 // ) ,具体参照代码示例写法
  2. 缩进与下一行代码保持一致;
  3. 可位于一个代码行的末尾,与代码间隔一个空格
/* Modal header */
.modal-header {
    ...
}

/*
 * Modal header
 */
.modal-header {
    ...
}

.modal-header {
    /* 50px */
    width: 50px;

    color: red; /* color red */
}

引号

  1. 最外层统一使用双引号;
  2. url的内容要用引号;
  3. 属性选择器中的属性值需要引号。 ```css .element:after { content: “”; background-image: url(“logo.png”); }

li[data-type=”single”] { … }

<a name="RNHNn"></a>
## 命名

- 类名使用小写字母,以中划线分隔
- id采用驼峰式命名
- SCSS中的变量、函数、混合、%placeholder采用驼峰式命名
```css
/* class */
.element-content {
    ...
}

/* id */
#myDialog {
    ...
}

/* 变量 */
$colorBlack: #000;

/* 函数 */
@function pxToRem($px) {
    ...
}

/* 混合 */
@mixin centerBlock {
    ...
}

/* placeholder */
%myDialog {
    ...
}

颜色

  1. 颜色16进制用小写字母。在扫描文档时,小写字符易于分辨,因为他们的形式更易于区分
  2. 颜色16进制尽量用简写 ```css / not good / .element { color: #ABCDEF; background-color: #001122; }

/ good / .element { color: #abcdef; background-color: #012; }


<a name="7WUTs"></a>
## 选择器

1. 对于通用元素使用 class ,这样利于渲染性能的优化。
1. 对于经常出现的组件,避免使用属性选择器(例如,`[class^="..."]`)。浏览器的性能会受到这些因素的影响。
1. 选择器要尽可能短,并且尽量限制组成选择器的元素个数,建议不要超过 3 。
1. **只有**在必要的时候才将 class 限制在最近的父元素内(也就是后代选择器)(例如,不使用带前缀的 class 时 -- 前缀类似于命名空间)。

扩展阅读:

- [Scope CSS classes with prefixes](http://markdotto.com/2012/02/16/scope-css-classes-with-prefixes/)
- [Stop the cascade](http://markdotto.com/2012/03/02/stop-the-cascade/)

<a name="p2F0m"></a>
## 属性顺序

1. 相关的属性声明应当归为一组,并按照下面的顺序排列:
   1. Positioning
   1. Box model
   1. Typographic
   1. Visual
   1. Misc
2. 由于定位(positioning)可以从正常的文档流中移除元素,并且还能覆盖盒模型(box model)相关的样式,因此排在首位。盒模型排在第二位,因为它决定了组件的尺寸和位置
2. 其他属性只是影响组件的 _内部_ 或者是不影响前两组属性,因此排在后面

完整的属性列表及其排列顺序请参考 [Bootstrap property order for Stylelint](https://github.com/twbs/stylelint-config-twbs-bootstrap/blob/master/css/index.js)
```css
.declaration-order {
  /* Positioning */
  position: absolute;
  top: 0;
  right: 0;
  bottom: 0;
  left: 0;
  z-index: 100;

  /* Box-model */
  display: block;
  float: right;
  width: 100px;
  height: 100px;

  /* Typography */
  font: normal 13px "Helvetica Neue", sans-serif;
  line-height: 1.5;
  color: #333;
  text-align: center;

  /* Visual */
  background-color: #f5f5f5;
  border: 1px solid #e5e5e5;
  border-radius: 3px;

  /* Misc */
  opacity: 1;
}

属性简写

  1. 属性简写需要你非常清楚属性值的正确顺序,而且在大多数情况下并不需要设置属性简写中包含的所有值,所以建议尽量分开声明会更加清晰;
  2. marginpadding 相反,需要使用简写;

常见的属性简写包括:

  • font
  • background
  • transition
  • animation ```css / not good / .element { transition: opacity 1s linear 2s; }

/ good / .element { transition-delay: 2s; transition-timing-function: linear; transition-duration: 1s; transition-property: opacity; }


<a name="iswXh"></a>
## 媒体查询

1. 尽量将媒体查询的规则靠近与他们相关的规则
1. 不要将他们一起放到一个独立的样式文件中,或者丢在文档的最底部,这样做只会让大家以后更容易忘记他们
```css
.element {
    ...
}

.element-avatar{
    ...
}

@media (min-width: 480px) {
    .element {
        ...
    }

    .element-avatar {
        ...
    }
}

SCSS相关

  1. 提交的代码中不要 @debug
  2. 声明顺序:
    1. @extend
    2. 不包含 @content@include
    3. 包含 @content@include
    4. 自身属性
    5. 嵌套规则
  3. @import 引入的文件不需要开头的 _ 和结尾的 .scss ,详情在这里

使用sass@import规则并不需要指明被导入文件的全名。你可以省略.sass.scss文件后缀。 当你@import一个局部文件时,还可以不写文件的全名,即省略文件名开头的下划线。

  1. 嵌套最多不能超过5层
  2. @extend 中使用placeholder选择器
  3. 去掉不必要的父级引用符号 &
  4. 操作符

为了提高可读性,在圆括号中的数学计算表达式的数值、变量和操作符之间均添加一个空格

/* not good */
@import "_dialog.scss";

/* good */
@import "dialog";

/* not good */
.fatal {
    @extend .error;
}

/* good */
.fatal {
    @extend %error;
}

/* not good */
.element {
    & > .dialog {
        ...
    }
}

/* good */
.element {
    > .dialog {
        ...
    }
}

/* not good */
.element {
  margin: 10px 0 @variable*2 10px;
}

/* good */
.element {
  margin: 10px 0 (@variable * 2) 10px;
}

杂项

  1. 不允许有空的规则
  2. 元素选择器用小写字母
  3. 去掉小数点前面的0
  4. 去掉数字中不必要的小数点和末尾的0
  5. 属性值 0 后面不要加单位
  6. 同个属性不同前缀的写法需要在垂直方向保持对齐,具体参照代码示例的写法(仁者见仁)
  7. 无前缀的标准属性应该写在有前缀的属性后面
  8. 不要在同个规则里出现重复的属性,如果重复的属性是连续的则没关系
  9. 不要在一个文件里出现两个相同的规则
  10. border: 0; 代替 border: none;
  11. 选择器不要超过4层(在SCSS中如果超过四层应该考虑用嵌套的方式来写)
  12. 发布的代码中不要有 @import。 不光增加了额外的请求次数,还会导致不可预料的问题。替代办法有以下几种:
    1. 使用多个 元素
    2. 通过 Sass 或 Less 之类的 CSS 预处理器将多个 CSS 文件编译为一个文件
    3. 通过 Rails、Jekyll 或其他系统中提供过 CSS 文件合并功能

详情在这里

  1. 尽量少用 * 选择器 ```css / not good / .selector, .selector-secondary, .selector[type=text] { padding:15px; margin:0px 0px 15px; background-color:rgba(0, 0, 0, 0.5); box-shadow:0px 1px 2px #CCC,inset 0 1px 0 #FFFFFF }

/ good / .selector, .selector-secondary, .selector[type=”text”] { padding: 15px; margin-bottom: 15px; background-color: rgba(0,0,0,.5); box-shadow: 0 1px 2px #ccc, inset 0 1px 0 #fff; }


---


<a name="OOWap"></a>
# JavaScript

<a name="LhHEF"></a>
## 变量声明

- 对所有的变量声明优先使用 `**const**` ;不要使用 `**var**`
```javascript
// not good
var a = 1;
var b = 2;

// good
const a = 1;
const b = 2;
  • 需要声明可变动变量,使用 let ,不要使用 var ```javascript // no good var count = 1; if (true) { count += 1; }

// good, use the let. let count = 1; if (true) { count += 1; }


- 一个函数作用域中所有的变量声明尽量提到函数首部
- 使用 `**const/let**` 声明每一个变量
- 将所有的 `**const**` 和 `**let**` 分组
```javascript
// no good
const items = getItems(),
    goSportsTeam = true,
    dragonball = 'z';

let i;
const items = getItems();
let dragonball;
const goSportsTeam = true;
let len;


// good
function doSomethingWithItems(items) {
  const  value = 10;
  const len = 10;
  let result = value + 10;
  let i;

  for (i = 0, len = items.length; i < len; i++) {
    result += 10;
  }
}

变量命名

  1. 标准变量采用驼峰式命名(除了对象的属性外,主要是考虑到CGI返回的数据)
  2. ‘ID’在变量名中全大写
  3. ‘URL’在变量名中全大写
  4. ‘Android’在变量名中大写第一个字母
  5. ‘iOS’在变量名中小写第一个,大写后两个字母
  6. 常量全大写,用下划线连接
  7. 类函数或构造函数,大写第一个字母
  8. jquery对象必须以’$’开头命名
  9. 不要使用保留字 ```javascript const thisIsMyName;

const goodID;

const reportURL;

const AndroidVersion;

const iOSVersion;

const MAX_COUNT = 10;

function Person(name) { this.name = name; }

class Person(name) { this.name = name; }

// not good const body = $(‘body’);

// good const $body = $(‘body’);


<a name="lzKxt"></a>
## 缩进
使用2空格

<a name="9B8xk"></a>
## 单行长度

1. 不要超过80
1. 但如果编辑器开启 `word wrap` 可以不考虑单行长度

<a name="DsSOH"></a>
## 分号
一下几种情况后需加分号:

- 变量声明
- 表达式
- return
- throw
- break
- continue
- do-while
```javascript
/* let declaration */
let x = 1;

/* expression statement */
x++;

/* do-while */
do {
    x++;
} while (x < 10);

空格

以下几种情况不需要空格:

  • 对象的属性的属性名后 ```javascript // not good let a = { b :1 };

// good let a = { b: 1 };


- 前缀一元运算符后,后缀一元运算符前
- 函数调用括号前
- 无论是函数声明还是函数表达式, `(` 前不要空格
- 数组的 `[` 后和 `]` 前
- 对象的 `{` 后和 `}` 前
- 运算符 `{` 后和 `}` 前

以下几种情况需要空格:

- 二元运算符前后
- 三元运算符  `?` `:`  前后
- 代码块 `{` 前
- 下列关键字前: `else` , `while`, `catch`, `finally`
- 下列关键字后:`if`, `else`, `for`, `while`, `do`, `switch`, `case`, `try`, `catch`, `finally`, `with`, `return`, `typeof`
- 单行 `//` 后(若单行注释和代码同行,则 `//` 前也需要),多行注释 `*` 后
- 对象的属性值前
- for循环,分号后留有一个空格,前置条件如果有多个,逗号后留一个空格
- 无论是函数声明还是函数表达式, `{` 前一定要有空格
- 函数的参数之间

<a name="50ldi"></a>
## 空行
以下几种情况需要空行:

- 变量声明后(当变量声明在代码块的最后一行时,则无需空行)
- 注释前(当注释在代码块的第一行时,无需空行)
- 代码块后(在函数调用、数组、对象中则无需空行)
- 文件最后保留一个空行
```javascript
// need blank line after variable declaration
const x = 1;

// not need blank line when variable declaration is last expression in the current block
if (x >= 1) {
    const y = x + 1;
}

let a = 2;

// need blank line before line comment
a++;

function b() {
    // not need blank line when comment is first line of block
    return a;
}

// need blank line after blocks
for (let i = 0; i < 2; i++) {
    if (true) {
        return false;
    }

    continue;
}

// not need blank line when in argument list, array, object
func(
    2,
    function() {
        a++;
    },
    3
);

const foo = [
    2,
    function() {
        a++;
    },
    3
];


const foo = {
    a: 2,
    b: function() {
        a++;
    },
    c: 3
};

换行

换行的地方,行末必须有 , 或者运算符
以下几种情况不需要换行:

  • 下列关键字前后:else, catch, finally
  • 代码块 {

以下几种情况需要换行:

  • 代码块 { 后和 }
  • 变量赋值后 ```javascript // not good const a = { b: 1 , c: 2 };

x = y ? 1 : 2;

// good const a = { b: 1, c: 2 };

x = y ? 1 : 2; x = y ? 1 : 2;

// no need line break with ‘else’, ‘catch’, ‘finally’ if (condition) { … } else { … }

try { … } catch (e) { … } finally { … }

// not good function test() { … }

// good function test() { … }

// not good const a, foo = 7, b, c, bar = 8;

// good const a, foo = 7, b, c, bar = 8;


<a name="N2phQ"></a>
## 单行注释

1. 双斜线后,必须跟一个空格
1. 缩进与下一行代码保持一致
1. 可位于一个代码行的末尾,与代码间隔一个空格
```javascript
if (condition) {
    // if you made it here, then all security checks passed
    allowed();
}

const zhangsan = 'zhangsan'; // one space after code

多行注释

最少三行, * 后跟一个空格,具体参照代码示例的写法
建议在以下情况下使用:

  • 难于理解的代码段
  • 可能存在错误的代码段
  • 浏览器特殊的HACK代码
  • 业务逻辑强相关的代码
    /*
    * one space after '*'
    */
    const x = 1;
    

文档注释

各类标签 @param , @method 等描述和例子请参考usejsdocJSDoc Guide(重要)
建议在以下情况下使用:

  • 所有常量
  • 所有函数
  • 所有类
    /**
    * @func
    * @desc 一个带参数的函数
    * @param {string} a - 参数a
    * @param {number} b=1 - 参数b默认值为1
    * @param {string} c=1 - 参数c有两种支持的取值</br>1—表示x</br>2—表示xx
    * @param {object} d - 参数d为一个对象
    * @param {string} d.e - 参数d的e属性
    * @param {string} d.f - 参数d的f属性
    * @param {object[]} g - 参数g为一个对象数组
    * @param {string} g.h - 参数g数组中一项的h属性
    * @param {string} g.i - 参数g数组中一项的i属性
    * @param {string} [j] - 参数j是一个可选参数
    */
    function foo(a, b, c, d, g, j) {
      ...
    }
    

引号

最外层统一使用单引号

// not good
const x = "test";

// good
const y = 'foo',
        z = '<div id="test"></div>';

函数

  1. 无论是函数声明还是函数表达式, ( 前不要空格,但 { 前一定要有空格
  2. 函数调用括号前不需要空格
  3. 立即执行函数外必须包一层括号
  4. 不要给inline function命名
  5. 参数之间用’, ‘分隔,注意逗号后有一个空格
  6. 不要把参数命名为 arguments。这将取代原来函数作用域内的 arguments 对象。
  7. 不要使用 arguments。可以选择 rest 语法 ... 替代
  8. 非函数代码块(ifwhile 等)中用函数表达式而不是函数声明
// no space before '(', but one space before'{'
const doSomething = function(item) {
    // do something
};

function doSomething(item) {
    // do something
}

// not good
doSomething (item);

// good
doSomething(item);

// requires parentheses around immediately invoked function expressions
(function() {
    return 1;
})();

// not good
[1, 2].forEach(function x() {
    ...
});

// good
[1, 2].forEach(function() {
    ...
});

// not good
const a = [1, 2, function a() {
    ...
}];

// good
const a = [1, 2, function() {
    ...
}];

// use ', ' between function parameters
const doSomething = function(a, b, c) {
    // do something
};

// no good
function concatenateAll() {
  const args = Array.prototype.slice.call(arguments);
  return args.join('');
}

// good
function concatenateAll(...args) {
  return args.join('');
}

// no good
if (currentUser) {
  function test() {
    console.log('Nope.');
  }
}

// good
let test;
if (currentUser) {
  test = () => {
    console.log('Yup.');
  };
}

数组、对象

  1. 对象属性名不需要加引号
  2. 对象以缩进的形式书写,不要写在一行
  3. 数组、对象最后不要有逗号(仁者见仁)
  4. 创建数组、对象要使用字面量创建 ```javascript // not good const a = { ‘b’: 1 };

const a = {b: 1};

const a = { b: 1, c: 2, };

const d = new Array();

const e = new Object();

// good const a = { b: 1, c: 2 };

const d = {};

const e = [];


4. 别使用保留字作为键值,在IE8上不会运行
```javascript
// bad
const superman = {
  default: { clark: 'kent' },
  private: true,
};

// good
const superman = {
  defaults: { clark: 'kent' },
  hidden: true,
};
  1. 使用对象方法、属性值的简写 ```javascript const lukeSkywalker = ‘Luke Skywalker’;

// no good const obj = { lukeSkywalker: lukeSkywalker,

addValue: function (value) { return atom.value + value; }, };

// good const atom = { lukeSkywalker,

addValue(value) { return atom.value + value; }, };


<a name="js2R1"></a>
## 括号
下列关键字后必须有大括号(即使代码块的内容只有一行):`if`, `else`, `for`, `while`, `do`, `switch`, `try`, `catch`, `finally`, `with`
```javascript
// not good
if (condition)
    doSomething();

// good
if (condition) {
    doSomething();
}

null

适用场景:

  • 初始化一个将来可能被赋值为对象的变量
  • 与已经初始化的变量做比较
  • 作为一个参数为对象的函数的调用传参
  • 作为一个返回对象的函数的返回值

不适用场景:

  • 不要用null来判断函数调用时有无传参(有可能是undefined?)
  • 不要与未初始化的变量做比较 ```javascript // not good function test(a, b) { if (b === null) {
      // not mean b is not supply
      ...
    
    } }

const a;

if (a === null) { … }

// good const a = null;

if (a === null) { … }

<a name="ZMy1L"></a>
## undefined

1. 永远不要直接使用undefined进行变量判断
1. 使用typeof和字符串'undefined'对变量进行判断
```javascript
undefined
永远不要直接使用undefined进行变量判断;

使用typeof和字符串'undefined'对变量进行判断。

ESLint

  1. 用’===’, ‘!==’代替’==’, ‘!=’
  2. for-in里一定要有hasOwnProperty的判断
  3. 不要在内置对象的原型上添加方法,如Array, Date
  4. 不要在内层作用域的代码里声明了变量,之后却访问到了外层作用域的同名变量
  5. 变量不要先使用后声明,使用let、const可以避免
  6. 不要在一句代码中单单使用构造函数,记得将其赋值给某个变量
  7. 不要在同个作用域下声明同名变量
  8. 不要在一些不需要的地方加括号,例:delete(a.b)
  9. 不要使用未声明的变量(全局变量需要加到.jshintrc文件的globals属性里面)
  10. 不要声明了变量却不使用
  11. 不要在应该做比较的地方做赋值
  12. debugger不要出现在提交的代码里
  13. 数组中不要存在空元素;
  14. 不要在循环内部声明函数;
  15. 不要像这样使用构造函数,例:new function () { ... }, new Object
// not good
if (a == 1) {
    a++;
}

// good
if (a === 1) {
    a++;
}

// good
for (key in obj) {
    if (obj.hasOwnProperty(key)) {
        // be sure that obj[key] belongs to the object and was not inherited
        console.log(obj[key]);
    }
}

// not good
Array.prototype.count = function(value) {
    return 4;
};

// not good
let x = 1;

function test() {
    if (true) {
        let x = 0;
    }

    x += 1;
}

// not good
function test() {
    console.log(x);

    const x = 1;
}

// not good
new Person();

// good
const person = new Person();

// not good
delete(obj.attr);

// good
delete obj.attr;

// not good
if (a = 10) {
    a++;
}

// not good
const a = [1, , , 2, 3];

// not good
const nums = [];

for (let i = 0; i < 10; i++) {
    (function(i) {
        nums[i] = function(j) {
            return i + j;
        };
    }(i));
}

// not good
const singleton = new function() {
    let privateVar;

    this.publicMethod = function() {
        privateVar = 1;
    };

    this.publicMethod2 = function() {
        privateVar = 2;
    };
};

杂项

  1. 不要混用tab和space
  2. 不要在一处使用多个tab或space;
  3. 换行符统一用 LF
  4. 对上下文this的引用只能使用 _this , that , self 其中一个来命名
  5. 行尾不要有空白字符
  6. switch的falling through和no default的情况一定要有注释特别说明
  7. 不允许有空的代码块 ```javascript // not good const a = 1;

function Person() { // not good const me = this;

// good
const _this = this;

// good
const that = this;

// good
const self = this;

}

// good switch (condition) { case 1: case 2: … break; case 3: … // why fall through case 4 … break; // why no default }

// not good with empty block if (condition) {

} ```

编辑器editorconfig配置

将你的编辑器按照下面的配置进行设置,以避免常见的代码不一致和差异:

  • 用两个空格代替制表符(soft-tab 即用空格代表 tab 符)
  • 保存文件时,删除尾部的空白符
  • 设置文件编码为 UTF-8
  • 在文件结尾添加一个空白行

参照文档并将这些配置信息添加到项目的 .editorconfig 文件中。例如:Bootstrap 中的 .editorconfig 实例。更多信息请参考 about EditorConfig
需要编辑器支持,例如vscode中需要:

  • 安装 EditorConfig for VS Code
  • 全局安装或局部安装editorconfig依赖包( npm install -g editorconfig | npm install -D editorconfig )

    TODO

总结vscode 配置

总结文档注释的标签

具体参考JSDoc Guide

总结 Vue 代码风格

具体参考vue代码风格介绍

参考与感谢

主要参考以下文章

感谢以上团队或个人