美文网首页
规范代码编写风格就用 eslint 和 prettier

规范代码编写风格就用 eslint 和 prettier

作者: 一颗冰淇淋 | 来源:发表于2022-05-15 22:21 被阅读0次

    eslint 可以用于规范我们的编码,使得项目中的代码风格一致,更利于阅读和维护,而 prettier 可以在当我们代码不符合 eslint 规范是进行部分自动修复。

    eslint

    通过 npm install eslint -D 安装 eslint,然后执行 npx eslint --init 初始化配置文件

    在执行 init 操作的时候,eslint 生成配置文件会问你一些问题

    • 想怎样来使用 eslint
    • 模块化的方式(Es module、commonjs)
    • 选择哪一种框架(React、Vue)
    • 是否需要 TypeScript
    • 项目运行在浏览器还是客户端
    • 指定怎样的代码规范(Airbnb、Standard、Google、XO)
    • 生成的配置文件类型(JavaScript、YAML、JSON)

    依次选择完成后再让它自动安装所需要的依赖。

    1_init操作.png

    在这些问题中,我选择了 使用 eslint 时检查代码发现问题后并提醒、模块化使用 commonjs、不需要框架和 TypeScript、项目运行在浏览器端,使用 airbnb 编码规范,生成配置文件为 JavaScript,这样就生成了 eslint 配置文件 .eslintrc.js

    2_eslintrc文件.png
    • env 表示当前eslint代码运行在什么环境
    • extends 表示继承的规则
    • parserOptions 里定义了 支持的 ecmaScript 版本
    • rules 中可以自定义规则

    有了这些规则之后,通过命令 npx eslint ./src/index.js来校验文件,依据 airbnb 的标准,五行代码检测出了六个错误和一个警告。

    3_eslint校验文件.png

    通过命令一个文件一个文件检测效率会比较低,在项目中可以直接配置 loader 来处理

    eslint-loader

    通过 npm install eslint-loader -D 安装依赖,在 webpack.config.js 中配置 eslint-loader 统一处理 js 文件

    module: {
      rules: [
        {
          test: /\.js$/,
          exclude: /node_modules/,
          use: ['eslint-loader'],
        },
      ],
    },
    

    执行 npm run build ,当文件有错误时,将不会通过编译

    4_eslint-loader.png

    vscode插件

    既然 eslint 检测出这么多错误,那我们得解决问题,使代码符合规范。

    以上报错和警告可以归纳为

    • quotes:Strings must use singlequote,表示必须使用单引号
    • semi:Missing semicolon,表示行尾少了分号
    • no-unused-vars,定义变量但没有使用
    • no-console,不期望使用 console 语句
    • import/prefer-default-export,建议使用默认导出

    其中无论是 eslint 工具还是 eslint-loader 报错代码都有提示 "4 errors and 0 warnings potentially fixable with the '--fix' option"。

    那我们通过 --fix 处理这个文件,通过 npx eslint --fix ./src/index.js 来执行,发现此时只剩工具帮我们修复了部分错误,包括行尾分号以及字符串单引号。

    5_--fix属性.png

    像上面的代码,在编写的过程中可能也不知道哪里有错误,如果平时编写代码的时候,能有不符合规范的错误提示,以及对于部分不规范代码能自动修复的话,比如双引号转换单引号,会给开发带来比较大的便利。

    vscode 中插件可以达到这样的效果, ESLint 用于报错提醒,Prettier 用于代码格式化。

    6_vscode插件.png

    ESLint 工具会读取本地的 eslint 配置,对文件进行报错和警告,标红表明"error",黄色下划线表示"warn"。

    7_eslint工具报错和警告.png

    prettier 自动格式化代码需要我们做一些配置,可以在 vscode 中通过 Settings 设置代码格式化规则,选择后会自动添加到 setting.json 中,比如单引号替代双引号。

    8_setting中配置prettier.png

    prettier 还可以在配置文件 .prettierrc 中进行项目的代码格式化规范,比如宽度超过100自动换行。

    9_prettierrc文件.png

    配置完成后,就可以通过快捷键自动格式化啦~

    修复错误

    无法通过工具自动修复的代码就只能自己手动来处理,我们可以通过三种方式来修复错误

    • 修改错误源代码
    • 将错误提醒关闭或者设置为"warn"
    • 将错误配置为项目中所需要的格式

    在 .eslintrc.js 里 rules 属性中配置自定义的规则,规则有三种选择方式,"off" 或 0 代表关闭校验,"warn" 或 1 代表不报错只警告,"error" 或 2 代表报错

    • 比如不希望有 console 语句,直接将 console 语句移除
    • 定义变量但没有使用不要报错只是警告 'no-unused-vars': 'warn'
    • 使用双引号报错,默认是单引号,但我们修改规定项目中的字符串就使用双引号 quotes: [2, 'double']

    通过 --fix 或者 prettier 自动修复之后,还剩两个错误和一个警告

    10_剩余错误.png

    警告不影响文件的编译,另外两个报错可以设置为关闭和警告

    rules: {
      'no-unused-vars': 'warn',
      'import/prefer-default-export': 0,
    },
    

    再次运行 npm run build,只剩两个警告,可以通过编译,代码也不再标红。

    11_错误修复.png

    eslint 和 prettier 在前端工程化方向有很大的作用,可以减少开发错误,帮助团队中形成比较一致的编码风格。

    以上就是 eslint 和 prettier 相关的总结, 更多有关webpack的内容可以参考我其它的博文,持续更新中~

    相关文章

      网友评论

          本文标题:规范代码编写风格就用 eslint 和 prettier

          本文链接:https://www.haomeiwen.com/subject/hnnburtx.html