vue中js里的/* eslint-disable*/及其ESLint的介绍

团队协作中，为了减少代码错误、节约调试时间、维持团队成员之间代码风格的统一，除了制定编码规范之外，我们往往需要借助工具来进行代码检测，辅助编码规范的实施。

ESLint是个不错的选择，由鼎鼎大名的Nicholas C. Zakas创建，是一个可组装的JavaScript和JSX检查工具。下面我们一起来看看怎么使用它。

一. 安装 
npm install eslint

二. 配置 
ESLint的配置有三种方式：

1、.eslintrc.*文件的配置 
首先你需要初始化配置文件。

eslint init

这将会在你的当前目录下生成一个.eslintrc.*文件。.eslintrc的后缀可以是.js、.yalm、.yml和.json中的任意一个。以.json格式为例。

.eslintrc.json 文件的内容类似如下： 
{ 
//extends用于引入某配置作为基础配置，然后再在后续的rules中对其进行扩展 
"extends": "eslint:recommended", 
//如果你想使用插件中的环境变量，请先把插件名写入"plugins"数组中，然后再在"env":{}中以"插件名/插件中的需引入的环境名"的方式进行指定。 
"plugins": ["example"], 
"env": { 
//An environment defines global variables that are predefined. 
//定义env会带进来一些全局变量 
"browser": true, 
"node": true, 
"es6":true, 
"mocha":"true", 
"qunit":true, 
"jquery":true, 
"mongo":true, 
//通过插件名命名空间引入插件中的环境 
"example/custom": true 
}, 
"globals": { 
// globals are the additional global variables your script accesses during execution. 
// 即插件在执行过程中用到的其它全局变量 
"angular": true, 
}, 
"rules": { 
//which rules are enabled and at what error level. 
//这里指定用哪些规则进行eslint检查以及每个规则的错误级别：0或者off表示规则关闭，出错也被忽略；1或者warn表示如果出错会给出警告；2或者error表示如果出错会报出错误 
"semi": ["error", "always"], 
"quotes": ["error", "double"] 
}, 
//parser指定解析器，默认的为espree，可选的还有Esprima、Babel-ESLint。 
//babel-eslint is a wrapper around the Babel parser that makes it compatible with ESLint. 
//babel-eslint是一个Babel parser的包装器，这个包装器使得Babel parser可以和ESLint协调工作 
"parser": "babel-eslint", 
"parserOptions": { 
//ecmaVersion指定ECMAScript的版本，可选值有3567，默认是5 
"ecmaVersion": 6, 
//sourceType指定被检查的文件是什么扩展名的，可选项"script"和"module"，默认是"script"。"module"是ES6的。 
"sourceType": "module", 
//ecmaFeatures指定你想使用哪些额外的语言特性 
"ecmaFeatures": { 
"jsx": true 
} 
}, 
} 
“rules”中的每一项即是一条规则。其中,“:”之前的事规则的名称（如上面的”semi” 和 “quotes”），“:”后面的数组中，第一个项用于指定规则的错误级别，它有 3 个可选的取值：

“off” 或者 0 - 关闭规则

“warn” or 1 - 不符合规则时作为一个警告（不会影响退出码）

“error” or 2 - 不符合规则时视作一个错误 (退出码为1)

在你的.eslintrc文件中包含这行代码，可以使用推荐规则。

"extends": "eslint:recommended"

通过这行代码，会开启规则页中标有对勾符号的规则。当然，你也可以到 npmjs.com 搜索 “eslint-config” 查找别人创建好的配置列表，并拿来直接使用。

.eslintrc.如果放在项目的根目录中，则会作用于整个项目。如果在项目的子目录中也包含着.eslintrc文件，则对于子目录中文件的检查会忽略掉根目录中的配置，而直接采用子目录中的配置，这就能够在不同的目录范围内应用不同的检查规则，显得比较灵活。ESLint采用逐级向上查找的方式查找.eslintrc.文件，当找到带有”root”: true配置项的.eslintrc.*文件时，将会停止向上查找。

“extends”除了可以引入推荐规则，还可以以文件形式引入其它的自定义规则，然后在这些自定义规则的基础上用rules去定义个别规则，从而覆盖掉”extends”中引入的规则。例如： 
{ 
"extends": [ 
"./node_modules/coding-standard/eslintDefaults.js", 
// Override eslintDefaults.js 
"./node_modules/coding-standard/.eslintrc-es6", 
// Override .eslintrc-es6 
"./node_modules/coding-standard/.eslintrc-jsx", 
], 
"rules": { 
// Override any settings from the "parent" configuration 
"eqeqeq": "warn" 
} 
}

2、在 package.json 中加入 eslintConfig 配置块进行配置 
例如： 
{ 
"name": "demo", 
"version": "1.0.0", 
"eslintConfig": { 
"env": { 
"browser": true, 
"node": true 
}， 
"rules": { 
"eqeqeq": "warn" 
} 
} 
} 
3、直接在代码文件中以注释的方式定义 
需要注意的是，代码文件内以注释配置的规则会覆盖配置文件里的规则，即优先级要更高。

例如：

临时在一段代码中取消eslint检查，可以如下设置： 
`/* eslint-disable */

// Disables all rules between comments 
alert(‘foo’);

/* eslint-enable */

临时在一段代码中取消个别规则的检查（如no-alert, no-console）：

/* eslint-disable no-alert, no-console */

// Disables no-alert and no-console warnings between comments 
alert(‘foo’); 
console.log(‘bar’);

/* eslint-enable no-alert, no-console */

在整个文件中取消eslint检查：

/* eslint-disable */

// Disables all rules for the rest of the file 
alert(‘foo’);

在整个文件中禁用某一项eslint规则的检查：

/* eslint-disable no-alert */

// Disables no-alert for the rest of the file 
alert(‘foo’);

针对某一行禁用eslint检查：

alert(‘foo’); // eslint-disable-line

// eslint-disable-next-line 
alert(‘foo’);

针对某一行的某一具体规则禁用eslint检查：

alert(‘foo’); // eslint-disable-line no-alert

// eslint-disable-next-line no-alert 
alert(‘foo’);

针对某一行禁用多项具体规则的检查：

alert(‘foo’); // eslint-disable-line no-alert, quotes, semi

// eslint-disable-next-line no-alert, quotes, semi 
alert(‘foo’);

三. 把ESLint集成到工作流之中 
比如，与babel和gulp结合：

package.json：

{
    "name": "my-module",
    "scripts": {
        "lint": "eslint my-files.js"
    },
    "devDependencies": {
        "babel-eslint": "...",
        "eslint": "..."
    }
}

　　

或者：

gulpfile.js

var gulp = require('gulp');
var eslint = require('gulp-eslint');

gulp.task('lint', function() {
  return gulp.src('app/**/*.js')
    .pipe(eslint())
    .pipe(eslint.format());
});
eslintrc.*：

{
    "plugins": [
        "react" //使用eslint-plugin-react插件
    ],
    "ecmaFeatures": {
        "jsx": true //开启ESLint JSX 支持
    }
    "rules": {
        "react/display-name": 1, //注意一下，自定义规则都是以插件名称为命名空间的
        "react/jsx-boolean-value": 1
    }
}

　　

四. 通过配置.eslintignore文件忽略掉不想被检查的文件 
可以通过在项目目录下建立.eslintignore文件，并在其中配置忽略掉对哪些文件的检查。需要注意的是，不管你有没有在.eslintignore中进行配置，eslint都会默认忽略掉对/node_modules/* 以及 /bower_components/*文件的检查。下面是一个简单的.eslintignore文件的内容。

# Ignore built files except build/index.js
build/
!build/index.js

　　

五. 执行检测 
eslint test.js test2.js

转自：https://blog.csdn.net/qq_31001889/article/details/81205632

团队协作中，为了减少代码错误、节约调试时间、维持团队成员之间代码风格的统一，除了制定编码规范之外，我们往往需要借助工具来进行代码检测，辅助编码规范的实施。

ESLint是个不错的选择，由鼎鼎大名的Nicholas C. Zakas创建，是一个可组装的JavaScript和JSX检查工具。下面我们一起来看看怎么使用它。

一. 安装 
npm install eslint

二. 配置 
ESLint的配置有三种方式：

1、.eslintrc.*文件的配置 
首先你需要初始化配置文件。

eslint init

这将会在你的当前目录下生成一个.eslintrc.*文件。.eslintrc的后缀可以是.js、.yalm、.yml和.json中的任意一个。以.json格式为例。

.eslintrc.json 文件的内容类似如下： 
{ 
//extends用于引入某配置作为基础配置，然后再在后续的rules中对其进行扩展 
"extends": "eslint:recommended", 
//如果你想使用插件中的环境变量，请先把插件名写入"plugins"数组中，然后再在"env":{}中以"插件名/插件中的需引入的环境名"的方式进行指定。 
"plugins": ["example"], 
"env": { 
//An environment defines global variables that are predefined. 
//定义env会带进来一些全局变量 
"browser": true, 
"node": true, 
"es6":true, 
"mocha":"true", 
"qunit":true, 
"jquery":true, 
"mongo":true, 
//通过插件名命名空间引入插件中的环境 
"example/custom": true 
}, 
"globals": { 
// globals are the additional global variables your script accesses during execution. 
// 即插件在执行过程中用到的其它全局变量 
"angular": true, 
}, 
"rules": { 
//which rules are enabled and at what error level. 
//这里指定用哪些规则进行eslint检查以及每个规则的错误级别：0或者off表示规则关闭，出错也被忽略；1或者warn表示如果出错会给出警告；2或者error表示如果出错会报出错误 
"semi": ["error", "always"], 
"quotes": ["error", "double"] 
}, 
//parser指定解析器，默认的为espree，可选的还有Esprima、Babel-ESLint。 
//babel-eslint is a wrapper around the Babel parser that makes it compatible with ESLint. 
//babel-eslint是一个Babel parser的包装器，这个包装器使得Babel parser可以和ESLint协调工作 
"parser": "babel-eslint", 
"parserOptions": { 
//ecmaVersion指定ECMAScript的版本，可选值有3567，默认是5 
"ecmaVersion": 6, 
//sourceType指定被检查的文件是什么扩展名的，可选项"script"和"module"，默认是"script"。"module"是ES6的。 
"sourceType": "module", 
//ecmaFeatures指定你想使用哪些额外的语言特性 
"ecmaFeatures": { 
"jsx": true 
} 
}, 
} 
“rules”中的每一项即是一条规则。其中,“:”之前的事规则的名称（如上面的”semi” 和 “quotes”），“:”后面的数组中，第一个项用于指定规则的错误级别，它有 3 个可选的取值：

“off” 或者 0 - 关闭规则

“warn” or 1 - 不符合规则时作为一个警告（不会影响退出码）

“error” or 2 - 不符合规则时视作一个错误 (退出码为1)

在你的.eslintrc文件中包含这行代码，可以使用推荐规则。

"extends": "eslint:recommended"

通过这行代码，会开启规则页中标有对勾符号的规则。当然，你也可以到 npmjs.com 搜索 “eslint-config” 查找别人创建好的配置列表，并拿来直接使用。

.eslintrc.如果放在项目的根目录中，则会作用于整个项目。如果在项目的子目录中也包含着.eslintrc文件，则对于子目录中文件的检查会忽略掉根目录中的配置，而直接采用子目录中的配置，这就能够在不同的目录范围内应用不同的检查规则，显得比较灵活。ESLint采用逐级向上查找的方式查找.eslintrc.文件，当找到带有”root”: true配置项的.eslintrc.*文件时，将会停止向上查找。

“extends”除了可以引入推荐规则，还可以以文件形式引入其它的自定义规则，然后在这些自定义规则的基础上用rules去定义个别规则，从而覆盖掉”extends”中引入的规则。例如： 
{ 
"extends": [ 
"./node_modules/coding-standard/eslintDefaults.js", 
// Override eslintDefaults.js 
"./node_modules/coding-standard/.eslintrc-es6", 
// Override .eslintrc-es6 
"./node_modules/coding-standard/.eslintrc-jsx", 
], 
"rules": { 
// Override any settings from the "parent" configuration 
"eqeqeq": "warn" 
} 
}

2、在 package.json 中加入 eslintConfig 配置块进行配置 
例如： 
{ 
"name": "demo", 
"version": "1.0.0", 
"eslintConfig": { 
"env": { 
"browser": true, 
"node": true 
}， 
"rules": { 
"eqeqeq": "warn" 
} 
} 
} 
3、直接在代码文件中以注释的方式定义 
需要注意的是，代码文件内以注释配置的规则会覆盖配置文件里的规则，即优先级要更高。

例如：

临时在一段代码中取消eslint检查，可以如下设置： 
`/* eslint-disable */

// Disables all rules between comments 
alert(‘foo’);

/* eslint-enable */

临时在一段代码中取消个别规则的检查（如no-alert, no-console）：

/* eslint-disable no-alert, no-console */

// Disables no-alert and no-console warnings between comments 
alert(‘foo’); 
console.log(‘bar’);

/* eslint-enable no-alert, no-console */

在整个文件中取消eslint检查：

/* eslint-disable */

// Disables all rules for the rest of the file 
alert(‘foo’);

在整个文件中禁用某一项eslint规则的检查：

/* eslint-disable no-alert */

// Disables no-alert for the rest of the file 
alert(‘foo’);

针对某一行禁用eslint检查：

alert(‘foo’); // eslint-disable-line

// eslint-disable-next-line 
alert(‘foo’);

针对某一行的某一具体规则禁用eslint检查：

alert(‘foo’); // eslint-disable-line no-alert

// eslint-disable-next-line no-alert 
alert(‘foo’);

针对某一行禁用多项具体规则的检查：

alert(‘foo’); // eslint-disable-line no-alert, quotes, semi

// eslint-disable-next-line no-alert, quotes, semi 
alert(‘foo’);

三. 把ESLint集成到工作流之中 
比如，与babel和gulp结合：

package.json：

{
    "name": "my-module",
    "scripts": {
        "lint": "eslint my-files.js"
    },
    "devDependencies": {
        "babel-eslint": "...",
        "eslint": "..."
    }
}

• 1
• 2
• 3
• 4
• 5
• 6
• 7
• 8
• 9
• 10
• 11
• 12

或者：

gulpfile.js

var gulp = require('gulp');
var eslint = require('gulp-eslint');

gulp.task('lint', function() {
  return gulp.src('app/**/*.js')
    .pipe(eslint())
    .pipe(eslint.format());
});
eslintrc.*：

{
    "plugins": [
        "react" //使用eslint-plugin-react插件
    ],
    "ecmaFeatures": {
        "jsx": true //开启ESLint JSX 支持
    }
    "rules": {
        "react/display-name": 1, //注意一下，自定义规则都是以插件名称为命名空间的
        "react/jsx-boolean-value": 1
    }
}

• 1
• 2
• 3
• 4
• 5
• 6
• 7
• 8
• 9
• 10
• 11
• 12
• 13
• 14
• 15
• 16
• 17
• 18
• 19
• 20
• 21
• 22
• 23
• 24

四. 通过配置.eslintignore文件忽略掉不想被检查的文件 
可以通过在项目目录下建立.eslintignore文件，并在其中配置忽略掉对哪些文件的检查。需要注意的是，不管你有没有在.eslintignore中进行配置，eslint都会默认忽略掉对/node_modules/* 以及 /bower_components/*文件的检查。下面是一个简单的.eslintignore文件的内容。

# Ignore built files except build/index.js
build/
!build/index.js

• 1
• 2
• 3

五. 执行检测 
eslint test.js test2.js