从 ESLint 入门到搭建完整的代码检查流程

阅读时长 4 分钟读完

代码的规范性和可读性一直都是前端开发中必须关注的问题之一。ESLint 是一个非常强大的工具,他可以帮助我们自动发现代码中可能存在的问题,并给出修复建议。本文将介绍如何从入门到搭建完整的代码检查流程,帮助我们在日常开发中更好地规范化我们的代码。

ESLint 的入门

安装

安装 ESLint 非常简单,只需要在命令行中运行以下命令即可:

配置

ESLint 的配置通过 .eslintrc 文件来完成。在项目的根目录下新建此文件,可以使用 JavaScript 或者 YAML 来编写。

下面是一个简单的示例:

这个配置文件,启用了 ESLint 的推荐配置,并添加了两个规则:强制使用分号和双引号。

运行

在命令行中运行 ESLint,给出文件或文件夹的路径:

或者可以通过配置 package.json 文件中的 script 属性,运行更加方便:

此时可以使用 npm run lint 来启动 ESLint。

集成到编辑器

也许最好的方法是将 ESLint 集成到我们的编辑器中,让它在我们编写代码时自动检查。

编辑器的配置可以使用 prettier,这里我们以 VS Code 为例:

  1. 首先,在 VS Code 中安装 eslint 插件。

  2. 然后,在项目中新建 .vscode/settings.json 文件,添加以下内容:

    -- -------------------- ---- -------
    -
      ---------------------- -----
      ------------------ -
        - ----------- ------ ---------- ---- --
        - ----------- ------- ---------- ---- --
        - ----------- ------------- ---------- ---- --
        - ----------- ------------------ ---------- ---- -
      -
    -
  3. 最后,编辑器在保存文件时,会自动进行代码规范检查,并给出相应的修复建议。

集成到 CI/CD 流程

将代码规范检查集成到 CI/CD 流程中,可以保证团队所有成员编写的代码风格统一,并且在代码提交之前自动进行检查。下面以 GitHub Actions 为例,介绍如何将 ESLint 集成到 CI/CD 流程中。

  1. 在项目根目录下新建 .github/workflows/ci.yml 文件。

  2. 在这个文件中,我们需要实现以下几个步骤:

    • 检出代码
    • 安装依赖
    • 运行 eslint
    -- -------------------- ---- -------
    ----- --
    
    ---
      -----
        ---------
          - ------
    
    -----
      ------
        -------- -------------
    
        ------
          - ----- --------
            ----- -------------------
    
          - ----- ----- -------
            ----- ---------------------
    
          - ----- ------- ------------
            ---- --- --
    
          - ----- ----
            ---- --- --- ----
  3. 提交代码并推送至 Github。

  4. 点击页面上的 Action,可以看到 CI 流程是否成功。

这样,我们就可以在 CI/CD 流程中集成 ESLint,保证代码的规范性。

总结

本文从 ESLint 的入门开始,介绍了配置和运行方法,以及如何在编辑器和 CI/CD 流程中集成 ESLint。代码规范性的确保是项目中很重要的环节,使用 ESLint 可以帮助我们在日常开发中更好地规范化我们的代码,提高代码的质量和可读性。

来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/645b078c968c7c53b0d639c8

纠错
反馈