Versions

核心概念

本页包含了 ESLint 的一些核心概念的高层次概述。

什么是 ESLint?

ESLint 是一个可配置的 JavaScript 检查器。它可以帮助你发现并修复 JavaScript 代码中的问题。问题可以指潜在的运行时漏洞、未使用最佳实践、风格问题等。

规则

规则是 ESLint 的核心构建块。规则会验证 你的代码是否符合预期,以及如果不符合预期该怎么做。规则还可以包含针对该规则的额外配置项。

比如 semi 规则会让你指定 JavaScript 语句结尾是否应该要有分号(;)。你可以通过设置规则来要求语句结尾总时要或绝不要有分号。

ESLint 包括数百个可以使用的内置规则。此外你也可以创建自定义规则或使用别人用插件创建的规则。

更多信息请参见规则

配置文件

ESLint 配置文件是指项目中存储 ESLint 配置的地方。可以包括内置规则、想要强制执行的内容、具有自定义规则的插件、可共享的配置,你希望规则适用于哪些文件等等。

更多信息请参见配置文件

可共享配置

可共享配置是指通过 npm 分享的 ESLint 配置。

通常可共享配置会被用于通过 ESLint 内置规则强制执行风格指南。比如可共享配置 eslint-config-airbnb-base 就实现了受欢迎的 Airbnb JavaScript 风格指南。

更多信息请参见使用可共享配置包

插件

ESLint 插件是一个包含 ESLint 规则、配置、解析器和环境变量的集合的 npm 模块。通常插件包括自定义规则。插件可以强制使用某个风格指南并支持 JavaScript 扩展(比如 TypeScript)、库(比如 React)和框架(比如 Angular)。

插件的流行用例就是强制执行框架规定的最佳实践。比如 @angular-eslint/eslint-plugin 包括了使用 Angular 框架的最佳实践。

更多信息请参见配置插件

解析器

ESLint 解析器将代码转换为 ESLint 可以评估的抽象语法树(AST, abstract syntax tree)。默认情况下,ESLint 使用内置的与标准 JavaScript运行时和版本兼容的 Espree 解析器。

自定义解析器让 ESLint 可以解析非标准的 JavaScript 语法。通常自定义解析器会被包含在可共享配置或插件中,这样你就不需要直接使用它们了。

比如用于让 ESLint 可以解析 TypeScript 代码的 @typescript-eslint/parser 解析器就被包含在 typescript-eslint 项目中。

自定义处理器

ESLint 处理器可以从其他类型的文件中提取 JavaScript 代码,然后让 ESLint 对 JavaScript 代码进行检查。另外,你也可以在用 ESLint 解析 JavaScript 代码之前使用处理器先对其进行处理。

例如 eslint-plugin-markdown 就包括一个自定义处理器,让你可以对 Markdown 代码块内的 JavaScript 代码进行检查。

格式化工具

ESLint 格式化工具决定了命令行输出的检查结果的样子。

更多信息请参见格式化工具

集成

ESLint 相关集成生态是使 ESLint 成为如此有用的工具的原因之一。例如,许多代码编辑器都有 ESLint 扩展,这让工作时,可以即刻在文件中查看相关的代码 ESLint 结果,这样你就不需要使用 ESLint 命令行来查看检查结果。

更多信息请参见集成

命令行 & Node.js API

ESLint 命令行是一个命令行界面,让你可以在终端进行检查。命令行有各种可以传递给命令的选项。

ESLint 的 Node.js API 让你可以在 Node.js 代码中以编程的方式使用 ESLint。该 API 在开发插件、集成和其他与 ESLint 相关的工具时非常有用。

除非你要以某种方式扩展 ESLint,否则你就应该使用命令行。

更多信息请参见命令行界面Node.js API

更改语言