盘点 JS 开发最佳实践之 ESLint

阅读时长 4 分钟读完

什么是 ESLint

ESLint 是一个 JavaScript 语法检查工具,可以用来规范代码风格,避免常见的 JavaScript 错误。ESLint 具有极高的灵活性和可配置性,可以根据团队和项目的需求进行定制化配置,比如可以使用 ESLint 来约定代码风格、标准化代码格式、预防和修复潜在 bug 等。

ESLint 的优势

  1. 合作开发更加统一性: ESLint 可以通过配置来统一整个团队的代码风格及标准,提高团队合作开发的效率和可维护性。
  2. 帮助开发者避免常见的错误: ESLint 可以检查并提示编码中的潜在 bug,比如变量未定义、对象属性可能为空等。
  3. 可定制化来降低故障修复成本: ESLint 可以根据个人习惯、语言工具和项目需求来进行自定义规则设置,减少故障排查的成本。

如何在项目中使用 ESLint

安装 ESLint

全局安装 ESLint:

或者在项目中安装:

配置和扩展 ESLint

在项目根目录中创建 .eslintrc.js 文件,配置如下:

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

这里我们使用了三种扩展配置:

  1. eslint:recommended:ESLint 官方提供的推荐规则集。
  2. plugin:react/recommended:React 官方指定的 ESLint 规则集。
  3. plugin:@typescript-eslint/recommended:提供 TypeScript 语法支持。

同时可以在rules中添加自己的规则。

应用 ESLint

在项目中使用 eslint 会报出一些提示警告和错误信息,如下:

整合 ESLint

当然直接使用 CLI 运行 ESLint 并改正代码错误是可行的,但如果你想编写更加高效且集成化的项目,则可以将 ESLint 与其他开发工具进行整合,如编辑器、自动修复插件等,以下是 VS Code 编辑器中 ESLint 的使用。

  1. 安装 VS Code 插件 ESLint。

  2. 打开 VS Code 配置。点击 File > Preferences > User settings 打开 VS Code 配置文件,或者使用快捷键 Ctrl + , / command + , 打开 VS Code 配载文件。

  3. 添加配置项

settings.json 中添加如下配置:

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

这里的配置主要使用了几个参数:

  • eslint.nodePath 设置项目的 node_modules 目录路径。
  • eslint.autoFixOnSave 在保存文件时自动修复代码错误。
  • editor.formatOnSave 在保存文件时格式化代码。
  • [language] 中 language 可用来分别针对不同的语言格式化代码。比如上面的示例就分别为 JavaScript、JavaScriptReact、TypeScript 和 TypeScriptReact。

总结

ESLint 是 JS 开发的一项好工具,可以帮助我们避免常见的编码错误,提高代码质量和可维护性。ESLint 可以配置非常多的规则,可以针对个人习惯、公司风格、项目业务需要等定制化配置。

ESLint 并没有强制国歌规范,更多时通过提示、警告和错误提醒来引导我们规范和标准化编码行为。尝试使用 ESLint,更加高效地开发。

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

纠错
反馈