vue中eslintrc.js配置最详细介绍

本文是对vue项目中自带文件eslintrc.js的内容解析， 介绍了各个eslint配置项的做用，以及为何这样设置。 比较详细，看完能对eslint有较为全面的了解，基本解除对该文件的疑惑。

/**
 * 参考文档
 * 【eslint英文文档】https://eslint.org/docs/user-guide/configuring
 * 【eslint中文文档】http://eslint.cn/docs/rules/
 */
 
/**
 * eslint有三种使用方式
 * 【1】js代码中经过注释的方式使用
 * 【2】经过webpack的eslintConfig字段设置，eslint会自动搜索项目的package.json文件中的配置
 * 【3】经过配置文件的方式使用，配置文件有多种文件方式，如JavaScript、JSON 或者 YAML等
 */
 
/**
 * 文件忽略
 * 【】让eslint跳过特定文件的检测
 * 【】经过当前工做目录下 「.eslintignore」 文件进行设置
 *  其使用的是Glob路径书写方式，与「.gitignore」的使用方法相同
 * 【】也能够在 package.json 文件中，经过 eslintIgnore 参数进行设置
 */
 
/**
 * 文件内局部设置
 * 【】eslint能够具体文件中设置特定代码的规则，经常使用于跳过某条语句的检测。
 * 【】注销所有规则，在代码前新建一行，添加注销 /* eslint-disable *\/  。若是没有恢复设置的语句，则下列所有代码都会跳过检测。
 * 【】恢复eslint，在代码前新建一行，添加注销 /* eslint-enable *\/
 * 【】指定忽略的规则，/* eslint-disable no-alert, no-console *\/
 * 【】在特定行禁用，// eslint-disable-line
 * 【】在下一行禁用，// eslint-disable-next-line
 */
 
module.exports = {
 
 /**
  * 根目录标识
  * http://eslint.cn/docs/user-guide/configuring#using-configuration-files
  * http://eslint.cn/docs/user-guide/configuring#configuration-cascading-and-hierarchy
  * 【】标识当前配置文件为最底层的文件，无需往更上一级的文件目录中进行搜索
  * 【】默认eslint的配置文件搜索方式是，从目标文件夹进行搜索，遍历内部每个文件夹，找到配置文件并层叠使用。再跳出本项目，往祖先文件夹进行遍历
  * 【】注意「~/.eslintrc」的意义，「~」是指linux上的家目录，「~/.eslintrc」是指家目录下的eslint配置文件，用于私人开发者，用于整个电脑全局约束的。这个配置经过本配置项root去设置，设置了root,eslint检测时将不会再往上搜索
  * 【】eslint的生效规则是就近使用，越近的配置项优先级越高，覆盖其余配置项。如一个项目中，能够在不一样文件夹中都添加配置文件，这些规则将重叠组合生效
  */
 root: true, // 标识当前配置文件为eslint的根配置文件，让其中止在父级目录中继续寻找。
 
 
 /**
  * 解析器
  * http://eslint.cn/docs/user-guide/configuring#specifying-parser
  * 【】ESLint 默认使用Espree做为其解析器
  * 【】解析器必须是本地安装的一个 npm 模块。即必须按照在本地的node_module中
  * 【】解析器是用于解析js代码的，怎么去理解每个表达式，有点C++中编译器的概念，会对js进行一些语法分析，语义分析什么的，才能判断语句符不符合规范。而不是经过简单的字符串对比。
  * 【】解析器有不少，但兼容eslint的解析器有如下几个
  * Espree：默认解析器，一个从Esprima中分离出来的解析器，作了一些优化
  * Esprima：js标准解析器
  * Babel-ESLint： 一个对Babel解析器的包装，babel自己也是js解析器的一种（否则怎么能转化为兼容性代码呢？首先须要进行js解析，才能转化）。若是咱们的代码须要通过babel转化，则对应使用这个解析器
  * typescript-eslint-parser(实验) - 一个把 TypeScript 转换为 ESTree 兼容格式的解析器
  */
 parser: 'babel-eslint',
 
 
 /**
  * 解析器配置项
  * http://eslint.cn/docs/user-guide/configuring#specifying-parser-options
  * 【】这里设置的配置项将会传递到解析器中，被解析器获取到，进行必定的处理。具体被利用到，要看解析器的源码有没有对其进行利用。这里仅仅作了参数定义，作了规定，告诉解析器的开发者可能有这些参数
  * 【】配置项目有：
  * "sourceType": "module",  // 指定JS代码来源的类型，script(script标签引入？) | module（es6的module模块），默认为script。为何vue的会使用script呢？由于vue是经过babel-loader编译的，而babel编译后的代码就是script方式
  * "ecmaVersion": 6,     // 支持的ES语法版本，默认为5。注意只是语法，不包括ES的全局变量。全局变量须要在env选项中进行定义
  * "ecmaFeatures": {     // Features是特征的意思，这里用于指定要使用其余那些语言对象
    "experimentalObjectRestSpread": true, //启用对对象的扩展
    "jsx": true,              //启用jsx语法
    "globalReturn":true,          //容许return在全局使用
    "impliedStrict":true          //启用严格校验模式
   }
  */
 parserOptions: {},
 
 
 /**
  * 运行环境
  * http://eslint.cn/docs/user-guide/configuring#specifying-environments
  * 【】一个环境定义了一组预约义的全局变量
  * 【】得到了特定环境的全局定义，就不会认为是开发定义的，跳过对其的定义检测。不然会被认为改变量未定义
  * 【】常见的运行环境有如下这些，更多的可查看官网
  * browser - 浏览器环境中的全局变量。
  * node - Node.js 全局变量和 Node.js 做用域。
  * es6 - 启用除了 modules 之外的全部 ECMAScript 6 特性（该选项会自动设置 ecmaVersion 解析器选项为 6）。
  * amd - 将 require() 和 define() 定义为像 amd 同样的全局变量。
  * commonjs - CommonJS 全局变量和 CommonJS 做用域 (用于 Browserify/WebPack 打包的只在浏览器中运行的代码)。
  * jquery - jQuery 全局变量。
  * mongo - MongoDB 全局变量。
  * worker - Web Workers 全局变量。
  * serviceworker - Service Worker 全局变量。
  */
 env: {
  browser: true, // 浏览器环境
 },
 
 
 /**
  * 全局变量
  * http://eslint.cn/docs/user-guide/configuring#specifying-globals
  * 【】定义额外的全局，开发者自定义的全局变量，让其跳过no-undef 规则
  * 【】key值就是额外添加的全局变量
  * 【】value值用于标识该变量可否被重写，相似于const的做用。true为容许变量被重写
  * 【】注意：要启用no-global-assign规则来禁止对只读的全局变量进行修改。
  */
 globals: {
  // gTool: true, // 例如定义gTool这个全局变量，且这个变量能够被重写
 },
 
 
 /**
  * 插件
  * http://eslint.cn/docs/user-guide/configuring#configuring-plugins
  * 【】插件一样须要在node_module中下载
  * 【】注意插件名忽略了「eslint-plugin-」前缀，因此在package.json中，对应的项目名是「eslint-plugin-vue」
  * 【】插件的做用相似于解析器，用以扩展解析器的功能，用于检测很是规的js代码。也可能会新增一些特定的规则。
  * 【】如 eslint-plugin-vue，是为了帮助咱们检测.vue文件中 <template> 和 <script> 中的js代码
  */
 plugins: [
  'vue'
 ],
 
 
 /**
  * 规则继承
  * http://eslint.cn/docs/user-guide/configuring#extending-configuration-files
  *【】可继承的方式有如下几种
  *【】eslint内置推荐规则，就只有一个，即「eslint:recommended」
  *【】可共享的配置， 是一个 npm 包，它输出一个配置对象。即经过npm安装到node_module中
  *  可共享的配置能够省略包名的前缀 eslint-config-，即实际设置安装的包名是 eslint-config-airbnb-base
  *【】从插件中获取的规则，书写规则为 「plugin:插件包名/配置名」，其中插件报名也是能够忽略「eslint-plugin-」前缀。如'plugin:vue/essential'
  *【】从配置文件中继承，即继承另外的一个配置文件，如'./node_modules/coding-standard/eslintDefaults.js'
  */
 extends: [
  'plugin:vue/essential', // 额外添加的规则可查看 https://vuejs.github.io/eslint-plugin-vue/rules/
  /**
   * 「airbnb，爱彼迎」
   * 【】有两种eslint规范，一种是自带了react插件的「eslint-config-airbnb」，一种是基础款「eslint-config-airbnb-base」，
   * 【】airbnb-base 包括了ES6的语法检测，须要依赖 「eslint-plugin-import」
   * 【】因此在使用airbnb-base时，须要用npm额外下载 eslint-plugin-import
   * 【】因此eslint实际上已经由于 airbnb-base 基础配置项目，添加上了 eslint-plugin-import 插件配置
   * 【】因此在setting和rules里，都有 'import/xxx' 项目，这里修改的就是 eslint-plugin-import 配置
   */
  'airbnb-base',
 ],
 
 
 /**
  * 规则共享参数
  * http://eslint.cn/docs/user-guide/configuring#adding-shared-settings
  * 【】提供给具体规则项，每一个参数值，每一个规则项都会被注入该变量，但对应规则而言，有没有用，就看各个规则的设置了，就比如 parserOptions，解析器用不用它就不知道了。这里只是提供这个方法
  * 【】不用怀疑，经源码验证，这就是传递给每一个规则项的，会当作参数传递过去，但用不用，就是具体规则的事情
  */
 settings: {
  /**
   *
   * 注意，「import/resolver」并非eslint规则项，与rules中的「import/extensions」不一样。它不是规则项
   * 这里只是一个参数名，叫「import/resolver」，会传递给每一个规则项。
   * settings并无具体的书写规则，「import/」只是import模块本身起的名字，原则上，它直接命名为「resolver」也能够，加上「import」只是为了更好地区分。不是强制设置的。
   * 由于「import」插件不少规则项都用的这个配置项，因此并无经过rules设置，而是经过settings共享
   * 具体使用方法可参考https://github.com/benmosher/eslint-plugin-import
   */
  'import/resolver': {
   /**
    * 这里传入webpack并非import插件能识别webpack，并且经过npm安装了「eslint-import-resolver-webpack」，
    * 「import」插件经过「eslint-import-resolver-」+「webpack」找到该插件并使用，就能解析webpack配置项。使用里面的参数。
    * 主要是使用如下这些参数，共享给import规则，让其正确识别import路径
    * extensions: ['.js', '.vue', '.json'],
    * alias: {
    * 'vue$': 'vue/dist/vue.esm.js',
    * '@': resolve('src'),
    * 'static': resolve('static')
    * }
    */
   webpack: {
    config: 'build/webpack.base.conf.js'
   }
  }
 },
 
 /**
  * 针对特定文件的配置
  * 【】能够经过overrides对特定文件进行特定的eslint检测
  * 【】特定文件的路径书写使用Glob格式，一个相似正则的路径规则，能够匹配不一样的文件
  * 【】配置几乎与 ESLint 的其余配置相同。覆盖块能够包含常规配置中的除了 extends、overrides 和 root 以外的其余任何有效配置选项，
  */
 overrides: [
  {
   'files': ['bin/*.js', 'lib/*.js'],
   'excludedFiles': '*.test.js',
   'rules': {
    'quotes': [2, 'single']
   }
  }
 ],
 
 /**
  * 自定义规则
  * http://eslint.cn/docs/user-guide/configuring#configuring-rules
  * 【】基本使用方式
  * "off" 或者0 关闭规则
  * "warn" 或者1 将规则打开为警告（不影响退出代码）
  * "error" 或者2 将规则打开为错误（触发时退出代码为1）
  * 如：'no-restricted-syntax': 0, // 表示关闭该规则
  * 【】若是某项规则，有额外的选项，能够经过数组进行传递，而数组的第一位必须是错误级别。如0,1,2
  * 如 'semi': ['error', 'never'], never就是额外的配置项
  */
 rules: {
  /**
   * 具体规则
   * 【】具体的规则太多，就不作介绍了，有兴趣的同窗能够上eslint官网查
   * 【】注意 xxx/aaa 这些规则是 xxx 插件自定的规则，在eslint官网是查不到的。须要到相应的插件官网中查阅
   * 【】如 import/extensions，这是「eslint-plugin-import」自定义的规则，须要到其官网查看 https://github.com/benmosher/eslint-plugin-import
   */
  'import/extensions': ['error', 'always', {
   js: 'never',
   vue: 'never'
  }],
  'import/no-extraneous-dependencies': ['error', {
   optionalDependencies: ['test/unit/index.js']
  }],
  'no-debugger': process.env.NODE_ENV === 'production' ? 'error' : 'off',
  "no-restricted-syntax": 0, //
  "guard-for-in": 0, //
  "prefer-const": 0, //
  "no-else-return": 0, //
  "no-plusplus": 0, // 不容许使用++符号
  "object-shorthand": ["error", "always", { "avoidQuotes": false }], // 去除禁止'videoData.isPause'(newValue) 的命名
  "no-lonely-if": 0, // 不容许给函数参数从新赋值
  "no-param-reassign": 0, // 不容许给函数参数从新赋值
  "no-mixed-operators": 0, // 不容许混合使用运算符
  "no-underscore-dangle": 0, // 不容许下划线做为变量名之一
  "no-under": 0, // 不容许混合使用运算符
  'generator-star-spacing': 'off',
  'no-console': 'off', // 禁用no-console规则
  'semi': ['error', 'never'], // 行尾不使用分号
  'comma-dangle': ['error'],
  'eqeqeq': 0, // 不须要强制使用全等
  'max-len': 0,
  'radix': 0,// parseInt不须要传第二个参数
  'linebreak-style': 0, // 强制执行一致的换行样式，windows和mac不同
  'consistent-return': 0, // 箭头函数最后不须要最后强制return值
  'no-unused-expressions': ["error", { "allowShortCircuit": true, "allowTernary": true }], // 容许您在表达式中使用三元运算符
  'no-multi-spaces': ['error', { "ignoreEOLComments": true }],
 }
}