如何使用 Prettier 与 ESLint 结合进行 JavaScript 代码格式化

阅读时长 7 分钟读完

前言

在开发过程中,代码的格式化一直是一个让人头疼的问题。不同的开发者有各自的编码风格,而这种风格的不统一可能会造成代码的可读性降低、维护的难度增大等问题。为了解决这个问题,出现了很多代码格式化工具,比如 Prettier 和 ESLint。本文介绍如何使用 Prettier 与 ESLint 结合,实现 JavaScript 代码的格式化。

Prettier

Prettier 是一款代码格式化工具,它可以自动检测代码中的格式问题,并对其进行格式化,使其符合规范。Prettier 支持多种编程语言,包括 JavaScript、TypeScript、HTML、CSS、Markdown 等。

Prettier 可以帮助我们解决以下问题:

  • 缩进样式不一致:开发者的缩进习惯不同,可能会出现缩进样式不一致的问题。
  • 行末空格:有些开发者在每行代码末尾都添加空格,而有些则没有。
  • 单/双引号:不同开发者对于字符串引号的选择也不一样。
  • 换行符:不同的操作系统可能会使用不同的换行符,如 Windows 使用 \r\n,而 Unix/Linux 使用 \n

ESLint

ESLint 是一款 JavaScript 代码静态分析工具,它可以检测代码中的潜在问题并给出提示,比如未定义变量、使用了不安全的方法等等。ESLint 支持多种规则和插件,以满足不同项目的需求。

ESLint 可以帮助我们解决以下问题:

  • 不规范的变量命名:开发者可能会使用不规范的变量命名方式,如使用大小写混合、使用数字等。
  • 重复代码:代码中可能会出现重复的代码,导致代码臃肿。
  • 安全问题:开发者可能会使用不安全的方法,如使用 eval() 方法,从而可能带来安全风险。
  • 其他一些不规范的写法:比如不加分号、使用 var 声明变量等。

Prettier 与 ESLint 结合

既然 Prettier 和 ESLint 都可以帮助我们解决代码质量问题,那么我们为什么不结合起来使用呢?Prettier 可以自动格式化代码,而 ESLint 可以检测代码质量问题,并给出提示。我们可以使用 Prettier 来格式化代码,再使用 ESLint 来检测问题。

具体地,我们可以使用 eslint-plugin-prettier 这个插件来将 Prettier 集成到 ESLint 中。这个插件可以将 Prettier 的格式化规则作为 ESLint 规则使用,这样当我们运行 eslint 命令时,就会自动将代码格式化为符合规范的样式。

下面是具体的操作步骤:

  1. 首先,我们需要安装 Prettier、ESLint 和 eslint-plugin-prettier。可以使用以下命令进行安装:

  2. 然后,在项目根目录下新建 .prettierrc 文件,并配置 Prettier 的格式化规则。例如,我们可以像下面这样配置:

    -- -------------------- ---- -------
    -
      ------------- ---
      ----------- --
      ---------- ------
      ------- -----
      -------------- -----
      ------------- ------------
      ----------------- ------
      ---------------- ------
      ----------------- -----
      -------------- --------
      ------------- --
      --------- --------
      ---------------- ------
      --------------- ------
      ------------ ----------
    -

    这里我们用到了 Prettier 的多个格式化规则,可以根据自己的需求进行配置。

  3. 接着,在项目根目录下新建 .eslintrc 文件,配置 ESLint。其中,我们需要添加 eslint-plugin-prettier 这个插件,并将其作为 extends 的一项。例如,我们可以像下面这样配置:

    -- -------------------- ---- -------
    -
      ---------- -
        ---------------------
        -----------------------------
      --
      ---------- -
        ----------
      --
      -------- -
        -------------------- -------
      -
    -

    这里我们使用了 eslint:recommended 预设规则和 eslint-plugin-prettier 提供的推荐规则。在 rules 中,我们将 prettier/prettier 规则设置为 "error",表示当代码不符合 Prettier 的格式化规则时,ESLint 将会给出错误提示。

到此为止,我们就完成了 Prettier 与 ESLint 的集成。使用上面的配置可以做到在提交代码之前,使用格式化器将代码格式化,由驱动器检查规范是否一致。

示例代码

下面是一个使用了 Prettier 与 ESLint 的示例代码:

app.js

-- -------------------- ---- -------
----- --- - -----
  ------------------
-

------

----- --- - -----
  -------------------
--

-----

----- --- - -- ---
  ------------------
-

------

----- ------ - -------------- ---- --

  --------------------

上面这段代码有一些不规范的写法,如:

  • 单/双引号不一致。
  • 缩进不规范。
  • 没有分号。
  • 没有使用 const 声明变量。
  • 对象字面量中的属性没有使用引号包裹。

运行 eslint 命令后,我们可以得到如下提示:

-- -------------------- ---- -------
--------------------------------
  ---  -----  -------- ----------- -- - ------ --- ----- -  -----------------
  ---  -----  ------- ---- --- -----------                  -----------------
  ---  -----  ------- ---------                             -----------------
  ---  -----  ----- -- -------- - ----- --- ----- ----      --------------
  ---  -----  ------- ---- --- -----------                  -----------------
  ----  -----  -------- -- -------- - ----- --- ----- ----  --------------

- - -------- -- ------- - ---------

可以看到,ESLint 检测到了代码中的格式问题,并给出了错误提示。我们可以根据提示修改代码,使其符合规范,例如:

-- -------------------- ---- -------
----- --- - -- -- -
  -------------------
--

------

----- --- - -- -- -
  -------------------
--

------

----- --- - -- -- -
  -------------------
--

------

----- ------ - - ----- -------- ---- - --

--------------------

修改后的代码已经去除了不规范的写法,并且使用了 const 声明变量,符合规范。运行 eslint 命令后,我们不会再得到任何提示。

结论

本文介绍了如何使用 Prettier 和 ESLint 结合,实现 JavaScript 代码的格式化。通过这种方式,我们可以将这两个工具的优点结合起来,自动格式化代码,达到统一的编码风格,提高代码的可读性和可维护性。

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

纠错
反馈