浅析ESlint的作用、演进历史、ESLint校验文件方式及常见配置介绍、2种配置方式、eslint检测配置文件的机制

提到ESLint,我们就不得不提及他的前辈们JSLint和JSHint,以及它们的区别。

1、JSLint:

JSLint 的灵感来源于C语言的检查工具 Lint,用来扫描C语言源文件以便找到其中的错误。

JSlint 是在2010年开源的第一款针对JS的语法检测工具,它和Lint做着相同的事,扫描JS的源文件来找到错误;它内部也是通过 fs.readFile来读取文件然后逐行来进行检查

JSLint的问题很明显:所有的配置项都内置不可配置,本身推崇 爱用不用的传统,不像开发者开放配置或者修改他觉得对的规则,因此很多人也无法忍受他的规则

2、JSHint,它的初衷就是为了能让开发者自定义规则 lint rules,因此提供了丰富的配置项,给开发者极大的自由

JSHint相比于JSLint,最大的特点就是可配置,我们可以在项目中放入一个 .jshintrc的配置文件,JSLint就会加载配置文件用于代码分析

由于JSHint是基于JSLint开发的,因此JSLint的一些问题也继承下来了,比如不易扩展以及不容易直接根据报错定位到具体的配置规则等

3、ESLint

2013年 Zakas 大佬发现JSHint无法满足自己定制化规则的需要,因此设想开发一个基于AST的Linter,可以动态执行额外的规则,同时可以很方面的扩展规则,于是在13年6月份开源推出了全新的ESLint。

灵感来源于PHP Linter, 将源码解析成AST,然后检测AST是否符合规则;ESLint最开始使用 esprima解析器将源码解析成AST,然后就可以使用任意规则来检测AST是否符合预期,这也是ESLint高可扩展的原因。

刚开始ESlint的推出并没有撼动JSHint的霸主地位,由于ESlint需要将源码转为AST,而JSHint直接检测源文件字符串,因此执行速度 比JSHint慢很多;真正让ESLint实现弯道超车的是ES6的出现

2015年,ES6规范发布后,由于大部分浏览器支持程度不高,因此需要Babel将代码转换编译成ES5或者更低版本;同时由于ES6变化很大,短期内JSHint无法完全支持,这时ESLint的高扩展性的优点显现出来了,不仅可以扩展规则,连默认的解析器也能替换;Babel团队就为ESLint开发了 babel-eslint替换默认的解析器 esprima,让ESLint率先支持ES6。

ESLint被设计成完全可配置的,我们可以用多种方式配置它的规则,或者配置要检测文件的范围。

1、初始化:如果想在现有的项目中引入eslint,我们可以在项目中进行初始化:

在经过一系列问答后,会在项目根目录创建一个我们熟悉的 .eslintrc.js配置文件;安装后就可以通过命令行对项目中的文件需要检测了:

一般我们会把eslint命令行配置到 packages.json中:

这里有一个 --fix后缀,是ESLint提供自动修复基础错误的功能,我们运行 lint:fix后发现有一些报错信息消失了,代码也改变了;不过它只能修复一些基础的不影响代码逻辑的错误,比如代码末尾加上分号、表达式的空格等等。

ESLint默认只会检测 .js后缀的文件,如果我们想对更多类型的文件进行检测,比如.vue、.jsx,可以使用 --ext选项,参数用逗号分隔:

对于一些公共的js,或者测试脚本,不需要进行检测,我们可以通过在项目根目录创建一个 .eslintignore告诉ESLint去忽略特定的目录或者文件:

除了 .eslintignore中指定的文件或目录,ESLint总是忽略 /node_modules/*/bower_components/*中的文件;因此对于一些目前解决不了的规则报错,但是我们需要打包上线,在不影响运行的情况下,我们就可以利用 .eslintignore文件将其暂时忽略。

2、ESLint一共有两种配置方式

(1)第一种方式是直接把lint规则嵌入源代码中;

  eqeqeq代表eslint校验规则,error代表校验报错级别,后面会详细说明;这个eslint校验规则只会对该文件生效

我们还可以使用其他注释,更精确地管理eslint对某个文件或某一行代码的校验:

(2)第二种方式是直接把lint规则放到我们的配置文件中,

上面init初始化生成的 .eslintrc.js就是一个配置文件,官方还提供了其他几种配置文件名称(优先级从上到下),一般情况下我们使用 .eslintrc.js就可以了。

1、globals 全局变量:脚本在执行期间访问的额外的全局变量

当访问当前源文件内未定义的变量时,no-undef 规则将发出警告。如果你想在一个源文件里使用全局变量,在Globals中定义这些全局变量,这样ESLint就不会发出警告了

首先是我们的 globals,ESLint会检测未声明的变量,并发出报错,比如node环境中的process,浏览器环境下的全局变量console,以及我们通过cdn引入的jQuery定义的$等;我们可以在 globals中进行变量声明:

2、env 环境

但是node或者浏览器中的全局变量很多,如果我们一个个进行声明显得繁琐,因此就需要用到我们的 env,这是对环境定义的一组全局变量的预设:一个环境定义了一组预定义的全局变量

指定不同的环境可以给对应环境下提供预设的全局变量,比如说在 browser 环境下,可以使用 window 全局变量;在 node 环境下,可以使用 process 全局变量等。
这些环境并不是互斥的,所以可以同时定义多个。可以在源文件里、在配置文件中或使用 命令行 的 --env 选项来指定环境。

更多的环境参数可以看ESLint声明环境。

3、parser解析器及解析参数parserOptions

这里可以类比webpack,自身只能处理js、及json文件,css、html等文件需要通过自定义loader处理来理解

我们上面说到ESLint可以更换解析器, "parse": "babel-eslint"就是用来指定要使用的解析器,它有以下几个选择:

  • esprima:ESLint最开始使用的解析器
  • espree:默认,ESLint自己基于esprima v1.2.2开发的一个解析器
  • babel-eslint:一个对Babel解析器的包装,使其能够与ESLint兼容。
  • @typescript-eslint/parser:将TypeScript转换成与estree兼容的形式,以便在ESLint中使用。

那么这几个解析器怎么选择呢?如果你想使用一些先进的语法(ES6789),就使用babel-eslint(需要npm安装);如果你想使用typescript,就使用@typescript-eslint/parser。

选好了解析器,我们可以通过 parserOptions给解析器传入一些其他的配置参数:

ESLint可以配置大量的规则,我们可以在配置文件的 rules属性自定义需要的规则:

对于检验规则,有3个报错等级:

  • “off” 或 0:关闭规则
  • “warn” 或 1:开启规则,warn级别的错误 (不会导致程序退出)
  • “error” 或 2:开启规则,error级别的错误(当被触发的时候,程序会退出)

有些规则没有属性,只需控制开启还是关闭;有些规则可以传入属性,我们通过数组的方式传入参数:

对于刚接触ESLint的同学,看到这么多的规则肯定很懵逼,难道要一条一条来记么?肯定不是的;项目的ESLint配置文件并不是一次性完成的,而是在项目开发中慢慢完善起来的,因为并不是所有的规则都是我们项目所需要的。因此我们可以先进行编码,在编码的过程中使用 npm run lint校验代码规范,如果报错,可以通过报错信息去详细查看是那一条规范报错:

比如这里的报错 no-unused-vars我们可以看到它来自第六行,再去文档查找,发现是我们在js中有一个定义了却未使用的变量;在团队协商后可以进一步来确定项目是否需要这条规范。

如果每条规则都需要团队协商配置还是比较繁琐的,在项目开始配置时,我们可以先使用一些业内已经成熟的、大家普遍遵循的编码规范(最佳实践);我们可以通过 extends字段传入一些规范,它接收String/Array:

extends可以使用以下几种类型的扩展:

  • eslint:开头的ESLint官方扩展,有两个: eslint:recommended(推荐规范)和 eslint:all(所有规范)。
  • plugin:开头的扩展是插件类型扩展
  • eslint-config:开头的来自npm包,使用时可以省略 eslint-config-,比如上面的可以直接写成 standard
  • @:开头的扩展和eslint-config一样,是在npm包上面加了一层作用域scope

需要注意的是:多个扩展中有相同的规则,以后面引入的扩展中规则为准。

  eslint:recommended推荐使用的规则在规则列表的右侧用 绿色√标记。

插件类型的扩展一般先通过npm安装插件,以上面的vue为例,我们先来安装:npm install –save-dev eslint eslint-plugin-vue

安装后一个插件中会有很多同类型扩展可供选择,比如vue就有以下几种扩展:

  • plugin:vue/base:基础
  • plugin:vue/essential:必不可少的
  • plugin:vue/recommended:推荐的
  • plugin:vue/strongly-recommended:强烈推荐

针对扩展中的规则,我们也能够通过rules来对它进行覆写

除了上面的 eslint-config-standard,还有以下几个比较知名的编码规范:

不过需要注意的是,很多规范不仅需要安装扩展本身,还需要配合插件,比如 eslint-config-standard,我们还需要安装下面几个插件才能有效:

ESLint虽然可以定义很多的 rules,以及通过 extends来引入更多的规则,但是说到底只是检查JS语法。如果需要检查 Vue中的 template或者 React中的 jsx,就束手无策了。所以引入插件的目的就是为了增强 ESLint的检查能力和范围。
在配置文件里配置插件时,可以使用 plugins 关键字来存放插件名字的列表。插件名称可以省略 eslint-plugin- 前缀。

在Webpack中,插件是用来扩展功能,让其能够处理更多的文件类型以及功能,ESLint中的插件也是同样的作用;虽然ESLint提供了几百种规则可供选择,但是随着JS框架和语法的发展,这么多规则还是显得不够,因为官方的规则只能检查标准的JS语法;如果我们写的是vue或者react的jsx,那么ESLint就不能检测了。

这时就需要安装ESLint插件,用来定制一些特色的规则进行检测;eslint插件以 eslint-plugin-开头,使用时可以省略;比如我们上面检测 .vue文件就用到 eslint-plugin-vue插件;需要注意的是,我们在配置 eslint-plugin-vue这个插件时,如果仅配置 "plugins": ["vue"],vue文件中template内容还是会解析失败。

这是因为不管是默认的espree还是babel-eslint解析器都无法解析.vue中template的内容; eslint-plugin-vue插件依赖 vue-eslint-parser解析器,而 vue-eslint-parser解析器只会解析template内容,不会检测 script中的JS内容,因此我们还需要指定一下解析器:

上面 parserOptions.parser不少同学肯定看的有点迷糊,这是由于外层的解析器只能有一个,我们已经用了 vue-eslint-parser就不能再写其他的;因此 vue-eslint-parser的做法是在解析器选项中再传入一个解析器选项用来处理 script中的JS内容。

如果想让ESLint检测vue文件,确保将 .vue后缀加入 --ext选项中。

学习链接:https://mp.weixin.qq.com/s/Gg37sEBsu3J5Ov6a8Frq5w

Original: https://www.cnblogs.com/goloving/p/16171055.html
Author: 古兰精
Title: 浅析ESlint的作用、演进历史、ESLint校验文件方式及常见配置介绍、2种配置方式、eslint检测配置文件的机制

原创文章受到原创版权保护。转载请注明出处:https://www.johngo689.com/547501/

转载文章受原作者版权保护。转载请注明原作者出处!

(0)

大家都在看

亲爱的 Coder【最近整理,可免费获取】👉 最新必读书单  | 👏 面试题下载  | 🌎 免费的AI知识星球