一看就懂的ESLint

Posted 2022-08-04 嘴巴嘟嘟

1.Eslint是用来干嘛的

ESLint最初是由Nicholas C. Zakas 于2013年6月创建的开源项目。它的目标是提供一个插件化的javascript代码检测工具。

2.为什么要使用Eslint

ESLint 是一个开源的 JavaScript 代码检查工具,。代码检查是一种静态的分析，常用于寻找有问题的模式或者代码，并且不依赖于具体的编码风格。对大多数编程语言来说都会有代码检查，一般来说编译程序会内置检查工具。
代码千万行，安全第一行；前端不规范，同事两行泪

1. 统一团队编码规范（命名，众多格式等）
2. 统一语法，毕竟es版本已经不少了(var/let…)
3. 减少git不必要的提交（如果文件格式不一样，也会被git提交的）
4. 避免低级错误 在编译时检查语法，而不是等JS引擎运行时才检查

3.手动下载配置(原理)

3.1 创建项目
创建一个测试文件夹：eslint_test
初始化项目：npm init -y (创建 package.json)
3.2 ESLint安装
直接在项目中安装eslint包 npm i eslint -D
注意安装结果：node_moduels 中下载了很多包

• .bin/eslint.cmd 脚本文件，内部通过 nodejs 执行 eslint运行包 的代码
  

• @eslint包 用来规范eslint配置文件
  

• eslint开头的包 是 eslint运行包，包含eslint代码
  
  3.3 生成ESLint配置文件
  使用 npx 来执行 (推荐)：npx eslint --init
  
  执行结果
  
  
  3.6 ESLint执行

• 命令：npx eslint ./需要检查语法的文件路径

• 如果违法规范，会将错误提示到 终端，说明 eslint 工作正常

4.ESLint配置文件入门

4.1 env节点

"env": 
    "browser": true,
    "commonjs": true,
    "es2021": true

由于 ESLint 的各种规范中，一般都不允许使用未在页面内声明的成员，所以告诉eslint，当前代码运行在那些环境中。
4.2 globals节点

当访问当前源文件内未定义的变量时，no-undef 规则将发出警告。如果你想在一个源文件里使用全局变量，推荐你在 ESLint 中定义这些全局变量，这样 ESLint 就不会发出警告了。你可以使用注释或在配置文件中定义全局变量。

 "globals": 
  "_": true  // 可以读取，可以修改
  "$": false // 可以读取，不能修改
 

可以使用 globals 节点来手动配置全局成员
4.3 extends 节点
通过这个节点可以配置使用 内置规范 还是 第三方规范

"extends": [
  "standard" // "eslint-config-standard"
 ]

注意：配置 extends时，可以省略 eslint-config-，直接写成 standard
4.4 parserOptions 节点
ESLint 解析器 解析代码时，可以指定 用哪个 js 的版本

 "parserOptions": 
  "ecmaVersion": 12
 

注意：这里是指定 检查时按照哪个js版本语法检查，但这里不包含 全局变量
4.5 rules 节点

 "rules": 
 

两种用法：

1. 不使用 extend 节点 配置 整套的规范，而是在 rules节点中直接配置
2. 使用 extend 节点 配置 整套的规范，在 rules节点中修改部分规范的配置

5.ESLint检查语法的规则

5.1 ESLint语法规范本质
本质就是函数
我们可以通过 看 ESLint 源码查看：

• eslint 内置285个规则，每条规则 都是一个 create函数
• 在进行语法检查时，会将代码转成另一种

6. 语法规范包类型

a. ESLint内置规范包 ：eslint-all / eslint-recommended

b. 标准规范包：eslint-config-standard

c. 第三方规范包(google/airbnb/facebook…)

6.1 内置规范包

已经随eslint一起下载：
eslint-all：使用全部280多个规则
eslint-recommended：只使用推荐的60个规则

6.2 标准规范包(需要下载)
包名：eslint-config-standard也使用了200多个规则
手动下载：
a. 查看需要下载的包和版本 npm info "eslint-config-airbnb-base@latest" peerDependencies
b.下载 相关包 npx install-peerdeps --dev eslint-config-airbnb-base

7. 配置规范包

7.1 修改 eslint 配置文件

module.exports = 
    "env": 
        "browser": true,
        "commonjs": true,
        "es2021": true
    ,
    // "extends": "eslint:all", // 内置：所有规则
    // "extends": "eslint:recommended", // 内置：推荐规则
    "extends": "eslint-config-standard", // 第三方：标准规则
    // "extends": "eslint-config-airbnb-base", // 第三方：airbnb公司规则
    "parserOptions": 
        "ecmaVersion": 12
    ,
    "rules": 
    
;

7.2 运行ESLint
注意：ESLint 默认只检查 js 文件代码，如果想 检查 vue 或 react文件，需要装其它插件包

npx eslint ./index.js // 检查 目标文件
npx eslint ./src // 检查 目标文件夹 中所有js文件

7.3 测试不同包检查相同代码
一段相同代码


注意：自己平时写代码还是要开启严格模式，要是去公司还得按照公司规范书写。