# ESLint

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/zh-cn/help/idea/llms.txt).

> **TL;DR**
> 必需插件  :
>
>
>
> `JavaScript 和 TypeScript` ：该插件与 IntelliJ IDEA 一起捆绑，并默认启用。

IntelliJ IDEA 集成了 [ESLint](http://eslint.org/)，提供了广泛的代码检查规则，并且可以通过插件进行扩展。 IntelliJ IDEA 会在编辑器中直接显示由 ESLint 报告的警告和错误，您在键入时即可看到。 借助 ESLint，您还可以使用 [JavaScript Standard Style](https://standardjs.com/)，以及 [对 TypeScript 代码进行代码检查](linting-typescript.html#ws_eslint_linting_typescript_files_with_eslint_intro)。

除 JavaScript 和 TypeScript 之外，ESLint 还可应用于整个项目或其特定部分中的其他类型文件，请参阅 [配置代码检查范围](#ws_eslint_configure_scope)。

## 开始之前

Procedure:

* 下载并安装 [Node.js](http://nodejs.org/#download)。

## 安装 ESLint

Procedure:

1. 在命令行 shell 或嵌入式   终端  （ `Alt+F12` (Windows), `⌥ F12` (macOS), `⌥ F12` (IntelliJ IDEA Classic (macOS)), `⌘ ⌃ T` (macOS System Shortcuts), `Alt+F12` (XWin), `Alt+F12` (GNOME), `Alt+F12` (KDE), `Alt+F12` (Emacs), `Alt+F12` (Sublime Text), `⌥ F12` (Sublime Text (macOS)), `Ctrl+Alt+1` (Visual Studio), `⌘ ⌃ 1` (Visual Studio (macOS)), `Alt+F12` (NetBeans), `Alt+F12` (Eclipse), `⌥ F12` (Eclipse (macOS))）中，输入以下命令之一：

npm:

* `npm init @eslint/config@latest` 以在当前项目中安装 ESLint 并生成一个配置文件。 回答向导中的问题。 结果是，IntelliJ IDEA 安装了最新版本的 ESLint 并生成了一个 `eslint.config.js` 配置文件。

* `npm install --save-dev eslint` 以将 ESLint 安装为开发依赖。

* `npm install --g eslint` 用于全局安装。

pnpm:

* `pnpm create @eslint/config@latest` 以在当前项目中安装 ESLint 并生成一个配置文件。 回答向导中的问题。 结果是，IntelliJ IDEA 安装了最新版本的 ESLint 并生成了一个 `eslint.config.js` 配置文件。

* `pnpm add -D eslint` 以将 ESLint 安装为开发依赖。

* `pnpm add -g eslint` 用于全局安装。

yarn:

* `yarn create @eslint/config` 以在当前项目中安装 ESLint 并生成一个配置文件。 回答向导中的问题。 结果是，IntelliJ IDEA 安装了最新版本的 ESLint 并生成了一个 `eslint.config.js` 配置文件。

* `yarn add -D eslint` 以将 ESLint 安装为开发依赖。

* `yarn add eslint` 用于全局安装。

2. 如果需要，安装其他插件，例如 [eslint-plugin-react](https://www.npmjs.com/package/eslint-plugin-react)来检查 React 应用程序的代码质量。

了解更多信息，请访问 [ESLint 官方网站](https://eslint.org/docs/latest/use/getting-started#quick-start)。

## 配置文件

### 支持的配置文件格式

根据您使用的 ESLint 版本，IntelliJ IDEA 能识别以下文件类型中的配置：

#### ESLint 版本 9 及更高版本

`eslint.config.js` 、  `eslint.config.mjs` 、  `eslint.config.cjs` （平面格式）、  `eslint.config.ts` 、  `eslint.config.mts`  或  `eslint.config .cts` 。 了解详情请访问 [ESLint 官方网站](https://eslint.org/docs/latest/use/configure/configuration-files#configuration-file)。

#### ESLint 版本 8 及更早版本

* `.eslintrc.*` （ `.eslintrc` 、 `.eslintrc.json` 或 `.eslintrc.yaml` 文件，或其他支持的格式文件）。

* `.eslintignore`

* `package.json` 带有 `eslintIgnore` 或 `eslintConfig` 属性。 此配置系统已被弃用，了解更多信息，请参阅 [ESLint 官方网站](https://eslint.org/docs/latest/use/configure/configuration-files-deprecated)。

了解如何从 [ESLint 配置迁移指南](https://eslint.org/docs/latest/use/configure/migration-guide) 切换到扁平格式。

### 创建和编辑配置文件

Procedure:

* 打开一个配置文件或在项目根目录中创建一个新文件。 根据您使用的 ESLint 版本填充配置文件：

ESLint 版本 9 及更高版本:

```JAVASCRIPT
// @ts-check

import eslint from '@eslint/js';
import tseslint from 'typescript-eslint';

export default tseslint.config(
        eslint.configs.recommended,
        tseslint.configs.recommended,
);

```

了解更多信息，请访问 [ESLint 官方网站。](https://eslint.org/docs/latest/use/configure/configuration-files)

ESLint 版本 8 及更早版本:

```JAVASCRIPT
/* eslint-env node */
module.exports = {
    extends: ['eslint:recommended', 'plugin:@typescript-eslint/recommended'],
    parser: '@typescript-eslint/parser',
    plugins: ['@typescript-eslint'],
    root: true,
};

```

了解更多信息，请访问 [ESLint 官方网站。](https://eslint.org/docs/latest/use/configure/configuration-files-deprecated)

## 在 IntelliJ IDEA 中配置 ESLint

默认情况下，ESLint 被 [自动](#ws_js_eslint_automatic_configuration) 配置。 您可以选择 [手动](#ws_js_eslint_manual_configuration) 指定所有配置设置或禁用 ESLint。

### 自动配置 ESLint

通过自动配置，IntelliJ IDEA 使用项目  `node_modules`  文件夹中的 ESLint 包以及当前文件所在文件夹中的  ``  配置文件。 如果在当前文件文件夹中未找到  ``  配置文件，IntelliJ IDEA 将在其父文件夹中查找，直到项目根目录。

如果您有多个  `package.json` 文件，将 ESLint 列为依赖项，IntelliJ IDEA 会为每个  `package.json` 单独启动一个进程，并处理其下的一切内容。 这可以让您将特定的 ESLint 版本或一组特定的插件应用到 monorepo 或具有多个 ESLint 配置的项目的每个路径。

Procedure:

* 要在当前项目中自动配置 ESLint，请打开   设置   对话框（ `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS))），转到  `语言 & 框架 | JavaScript | 代码质量工具 | ESLint` ，并选择   自动 ESLint 配置   选项。

* 要在所有新项目中自动配置 ESLint，请打开   新项目设置   对话框（  `文件 | 新建项目设置 | 新项目的 设置` ），转到  `语言 & 框架 | JavaScript | 代码质量工具 | ESLint` ，并选择   自动 ESLint 配置   选项。

### 手动配置 ESLint

通过手动配置，您可以使用自定义 ESLint 包、配置文件和工作目录，并应用各种附加规则和选项。

Procedure:

1. 在   设置   对话框（ `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS))）中，转到  `语言 & 框架 | JavaScript | 代码质量工具 | ESLint` ，然后选择   手动 ESLint 配置  。

2. 在   ESLint 软件包   字段中，指定  eslint  或  standard  包的位置。

3. 在   工作目录  字段中，指定 ESLint 进程的工作目录。

默认情况下，该字段为空，IntelliJ IDEA 会自动检测工作目录。 首先，它会查找包含 [配置文件](#ws_eslint_configuration_file_format) 的最接近被 lint 文件的目录。

如果自动检测到的工作目录与您的项目配置不匹配，您需要手动指定工作目录。 使用分号作为分隔符。 可接受的值是：

* 绝对路径。

* 与项目基本目录（存储 IntelliJ IDEA 特定项目信息的 `.idea` 文件夹的上级文件夹）相关的路径。 例如： 1. `./` ：使用项目基目录作为 ESLint 进程的工作目录。 2. `client;server` ：使用 `<project_base_dir>/client` 和 `<project_base_dir>/server` 作为工作目录。 对于既不在 `client` 也不在 `server` 文件夹下的文件，工作目录将会 [如上所述自动检测](#ws_js_eslint_manual_configuration_wd_autodetect)。 3. `packages/*` ： `<project_base_dir>/packages` 目录的每个子文件夹都将用作相应 linted 文件的工作目录。

* 如果某些经过 lint 的文件不在文件夹层次结构中的项目基目录下，您可以使用相对于内容根目录的路径。

* [Glob 模式](https://github.com/isaacs/node-glob#glob-primer)定义工作目录的相对路径。 例如，带有 `**/foo -*` 的每个以 `foo-` 开头的目录将被用作对应被 lint 的文件的工作目录。

4. 请选择要使用的配置。

* 自动搜索 ：选择此选项，如果 ESLint 规则配置在支持格式的 [配置文件](#ws_eslint_configuration_file_format) 中。 IntelliJ IDEA 从要检查的文件所在的文件夹开始查找此类文件，然后在其父文件夹中搜索，依此类推，直到项目根目录。

* 配置文件 — 选择此选项以使用自定义文件，并在 路径 字段中指定文件位置。

了解更多关于配置 ESLint 的信息，请访问 [ESLint 官方网站](https://eslint.org/docs/user-guide/configuring)。

5. 可选：

* 在 额外的 eslint 选项 字段中，指定运行 ESLint 的其他命令行选项，使用空格作为分隔符。 了解有关 ESLint CLI 选项的更多信息，请访问 [ESLint 官方网站](http://eslint.org/docs/user-guide/command-line-interface#options)。

* 在 附加规则目录 字段中，指定包含额外代码验证规则的文件位置。 这些规则将在默认配置文件或自定义配置文件中的规则之后应用，并相应地覆盖它们。 更多信息，请查看 ESLint 官网的 [ESLint 配置文件](https://eslint.org/docs/user-guide/configuring) 和 [添加规则](https://eslint.org/docs/user-guide/configuring#configuring-rules)。

### 配置 linting 范围

Procedure:

1. 打开   设置  对话框( `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)))，转到  `语言 & 框架 | JavaScript | 代码质量工具 | ESLint` ，然后选择   自动 ESLint 配置  或   手动 ESLint 配置  。

2. 在   运行 文件   字段中，指定定义要检查的文件集合的模式。 您可以接受默认模式或输入自定义模式。

默认模式下，  `**/*.{js,ts,jsx,tsx,cjs,cts,mjs,mts,html,vue}` ，ESLint 将会唤醒并处理任何更新的 JavaScript、TypeScript、JSX、TSX、HTML 或 Vue 文件。 要检查其他类型的文件或存储在特定文件夹中的文件，请使用 [glob patterns](https://github.com/isaacs/node-glob#glob)更新默认模式。

* 例如，要自动 lint CoffeeScript 文件，也可以将 `咖啡` 添加到默认模式中，如下所示： ``` **/*.{js,ts,jsx,tsx,cjs,cts,mjs,mts,html,vue,coffee} ```

* 若要检查特定文件夹（包括其子文件夹）中的文件，请将 `**/*` 替换为 `<path to the folder>/**/*` 。 假设您的项目具有以下结构： ![ESLint：自定义模式。 示例项目结构](https://resources.jetbrains.com/help/img/idea/2026.3/ws_eslint_configure_scope.png) 若要仅 lint `咖啡` 文件夹中的文件，请将模式更新如下： ``` coffee/*.{js,ts,jsx,tsx,cjs,cts,mjs,mts,html,vue,coffee} ``` 因此， `linting.coffee` 文件进行了 lint，而 `no_linting .coffee` 文件没有。

### 保存时自动修复问题

ESLint 可以在每次保存更改时修复检测到的问题，无论是手动保存、使用 `Ctrl+S` (Windows), `⌘ S` (macOS), `⌘ S` (IntelliJ IDEA Classic (macOS)), `⌘ S` (macOS System Shortcuts), `Ctrl+S` (XWin), `Ctrl+S` (GNOME), `Ctrl+S` (KDE), `Ctrl+X, Ctrl+S` (Emacs), `Ctrl+S` (Sublime Text), `⌘ S` (Sublime Text (macOS)), `Ctrl+Shift+S` (Visual Studio), `⌘ ⇧ S` (Visual Studio (macOS)), `Ctrl+S` (NetBeans), `Ctrl+S` (Eclipse), `⌘ S` (Eclipse (macOS))，还是自动保存、启动运行/调试配置、关闭 IntelliJ IDEA 或执行版本控制操作。欲了解更多信息，请参阅 [自动保存](saving-and-reverting-changes.html)。

Procedure:

* 打开   设置   对话框（ `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS))），转到  `语言 & 框架 | JavaScript | 代码质量工具 | ESLint` ，并选中   保存时运行 eslint --fix   复选框。

> **Tip:**
> 启用此选项还会启用 [Run eslint --fix](saving-and-reverting-changes.html#actions-on-save) 在  `设置 | 工具 | 保存时的操作` 。

## 检查您的代码

安装并启用后，ESLint 会在您每次打开 JavaScript 文件时自动激活。 您还可以配置 ESLint 以在保存时 [自动检测并修复问题](#ws_eslint_configure_run_eslint_on_save)。

默认情况下，IntelliJ IDEA 会根据 ESLint 配置中的严重性级别标记检测到的问题。 请参阅 [配置 ESLint 高亮显示](#ws_eslint_configure_highlighting)，了解如何覆盖这些设置。

您可以在编辑器以及 [问题](linters.html#ws_js_linters_general_problems_tool_window) 工具窗口的   文件   选项卡中查看当前文件中检测到的错误的描述及其快速修复。

所有之前打开的文件中的错误及其快速修复会显示在   项目错误   选项卡的   问题   工具窗口中。 若要打开工具窗口，请点击编辑器右上角的   检查   小组件：

![检查小部件](https://resources.jetbrains.com/help/img/idea/2026.3/inspection-widget.png)

有关详情，请参阅 [在编辑器中查看问题并应用快速修复](linters.html#ws_js_linters_editor)以及 [问题工具窗口](linters.html#ws_js_linters_general_problems_tool_window)。

### 在编辑器中查看问题并应用快速修复

Procedure:

* 要查看问题的说明，请将鼠标悬停在高亮显示的代码上。

![ESLint：错误和警告会被高亮显示，问题的描述显示在工具提示中。](https://resources.jetbrains.com/help/img/idea/2026.3/ws_eslint_show_description.png)

要解决检测到的问题，请点击   ESLint：修复“<规则名称>”  或按 `Alt+Shift+Enter` (Windows), `Alt+Shift+Enter` (macOS), `Alt+Shift+Enter` (IntelliJ IDEA Classic (macOS)), `Alt+Shift+Enter` (macOS System Shortcuts), `Alt+Shift+Enter` (XWin), `Alt+Shift+Enter` (GNOME), `Alt+Shift+Enter` (KDE), `Alt+Shift+Enter` (Emacs), `Alt+Shift+Enter` (Sublime Text), `Alt+Shift+Enter` (Sublime Text (macOS)), `Alt+Shift+Enter` (Visual Studio), `Alt+Shift+Enter` (Visual Studio (macOS)), `Alt+Shift+Enter` (NetBeans), `Alt+Shift+Enter` (Eclipse), `Alt+Shift+Enter` (Eclipse (macOS))。

要解决当前文件中的所有检测到的问题，请点击   更多操作   ( `Alt+Enter` (Windows), `⌥ ⏎` (macOS), `⌥ ⏎` (IntelliJ IDEA Classic (macOS)), `⌥ ⏎` (macOS System Shortcuts), `Alt+Enter` (XWin), `Alt+Enter` (GNOME), `Alt+Enter` (KDE), `Alt+Enter` (Emacs), `Alt+Enter` (Sublime Text), `⌥ ⏎` (Sublime Text (macOS)), `Alt+Enter` (Visual Studio), `⌥ ⏎` (Visual Studio (macOS)), `Alt+Enter` (NetBeans), `Ctrl+1` (Eclipse), `⌘ 1` (Eclipse (macOS)))并从列表中选择  `ESLint：修复当前文件` 。

![ESLint：解决问题](https://resources.jetbrains.com/help/img/idea/2026.3/ws_eslint_show_description_intention_actions.png)

如需更多信息，请参阅 [在编辑器中查看问题并应用快速修复](linters.html#ws_js_linters_editor)。

* 您还可以配置 ESLint 在保存文件时修复文件中的所有问题。 要配置此类行为，请在   保存时运行 eslint --fix   复选框，在   ESLint   页面的   设置   对话框中，如 [在 IntelliJ IDEA 中激活和配置 ESLint](#ws_js_eslint_activate) 所述。

### 在 Problems 工具窗口中检查您的代码

Procedure:

* 要打开   问题   工具窗口，请点击编辑器右上角的   检查   小部件。

![检查小部件](https://resources.jetbrains.com/help/img/idea/2026.3/inspection-widget.png)

或者，从主菜单中选择  `查看 | 工具窗口 | 问题`  或按 `Alt+6` (Windows), `⌘ 6` (macOS), `⌘ 6` (IntelliJ IDEA Classic (macOS)), `⌘ 6` (macOS System Shortcuts), `Alt+6` (XWin), `Alt+6` (GNOME), `Alt+6` (KDE), `Alt+6` (Emacs), `Alt+6` (Sublime Text), `⌘ 6` (Sublime Text (macOS)), `Alt+6` (Visual Studio), `⌘ 6` (Visual Studio (macOS)), `Alt+6` (NetBeans), `Alt+6` (Eclipse), `⌘ 6` (Eclipse (macOS))。

* 在   文件   选项卡中，您可以查看问题描述、应用快速修复、导航到源代码中出错的片段，并且无需离开工具窗口，便可在   编辑器预览   窗格中进行修复。 在 [问题工具窗口](problems-tool-window.html) 中详细了解。

![在问题工具窗口中的快速修复](https://resources.jetbrains.com/help/img/idea/2026.3/ws_js_eslint_problems_tw.png)

* 在   项目错误   选项卡中，您可以查看当前会话期间打开的所有文件中的错误，错误消息按检测到的文件分组。

![问题工具窗口，ESLint。 项目错误选项卡显示整个项目中先前打开文件的语法错误](https://resources.jetbrains.com/help/img/idea/2026.3/ws_problems_toolwindow_project_errors_linters.png)

在此，您可以查看问题描述、应用快速修复、导航到源代码中发生错误的片段，并且无需离开工具窗口即可在   编辑器预览   窗格中修复它们。 详细了解请参阅 [问题工具窗口](problems-tool-window.html)。

## 为 ESLint 配置高亮

默认情况下，IntelliJ IDEA 会根据 ESLint 配置中的严重性级别标记检测到的错误和警告。 例如，错误会用红色波浪线高亮显示，而警告会以黄色背景标出。 如需更多信息，请参阅 [代码检查](code-inspection.html) 和 [更改检查严重性](configuring-inspection-severities.html)。

### 在 ESLint 配置中更改规则的严重级别

Procedure:

* 在 [配置文件](#js_lint_eslint_config_file) 中，找到您想要编辑的规则，并将其值设置为  `1`   `警告`  或  `2`   `错误` 。

了解更多信息，请访问 [ESLint 官方网站](https://eslint.org/docs/user-guide/configuring#configuring-rules)。

### 忽略配置中的严重级别

您可以覆盖 ESLint 配置中的严重性，以便 IntelliJ IDEA 忽略它们，并将 linter 报告的所有内容显示为错误、警告或自定义颜色。

![为 ESLint 指定自定义严重级别](https://resources.jetbrains.com/help/img/idea/2026.3/ws_eslint_override_severity_from_linter_config.png)

Procedure: 忽略配置中的严重级别

1. 在   设置  对话框（ `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS))）中，选择  `编辑器 | 检查` 。 [检查页面](inspections-settings.html) 打开。

2. 在中央窗格中，转到   JavaScript | 代码质量工具 | ESLint  。

3. 在右侧窗格中，取消选中   从配置文件中使用规则严重性  复选框，然后选择要使用的严重级别来替代默认级别。

## 从 ESLint 导入代码样式

您可以将部分 [ESLint 代码样式 rules](http://eslint.org/docs/rules/) 导入到 IntelliJ IDEA 的 [JavaScript 代码样式 settings](settings-code-style-javascript.html) 中。 这使得 IntelliJ IDEA 在自动补全、生成、重构代码或添加导入语句时能够使用更准确的代码风格选项。 当您使用   重新格式化   操作时，IntelliJ IDEA 将不再破坏从 ESLint 角度看格式正确的代码。

IntelliJ IDEA 支持所有官方格式的 ESLint 配置文件，请参阅上文的 [支持的 ESLint 配置文件格式](#ws_eslint_configuration_file_format)：

* `eslint.config.js` 、 `eslint.config.mjs` 、 `eslint.config.cjs` 、 `eslint.config.ts` 、 `eslint.config.mts` 或 `eslint.config.cts` （平面格式），适用于 ESLint 版本 9 及更高版本。

* `.eslintrc` 文件和带有 `eslintConfig` 属性的 `package.json` 文件，适用于 ESLint 版本 8 及更早版本。

了解更多信息，请访问 [ESLint 官方网站](https://eslint.org/docs/latest/use/configure/configuration-files#configuration-file)。

Procedure:

* 当您第一次打开项目时，IntelliJ IDEA 会自动从项目的 ESLint 配置中导入代码样式。

* 如果您的 ESLint 配置已更新（手动或通过版本控制），请在编辑器中打开它，并从上下文菜单中选择   应用 ESLint 代码风格规则  。

![从 JavaScript 或 YAML 配置文件中导入 ESLint 代码风格规则](https://resources.jetbrains.com/help/img/idea/2026.3/ws_import_code_style_from_eslint_complex_config.png)

或者，只需在文件顶部的   "应用 ESLint 的代码样式？"  问题上回答   是  。

应用规则的列表显示在   通知   工具窗口中：

![事件日志工具窗口显示已应用的 ESLint 规则列表](https://resources.jetbrains.com/help/img/idea/2026.3/ws_import_code_style_from_eslint_event_log.png)

## 使用 JavaScript Standard Style

您可以将 [JavaScript Standard Style](https://standardjs.com/) 设置为应用程序的默认 JavaScript 代码样式，这样当您键入代码或重新格式化代码时，它的主要规则就会被应用。 由于 Standard 基于 ESLint，您也可以通过 IntelliJ IDEA ESLint 集成使用 Standard。

Procedure: 安装 JavaScript Standard

* 在命令行 shell 或嵌入式   终端  （ `Alt+F12` (Windows), `⌥ F12` (macOS), `⌥ F12` (IntelliJ IDEA Classic (macOS)), `⌘ ⌃ T` (macOS System Shortcuts), `Alt+F12` (XWin), `Alt+F12` (GNOME), `Alt+F12` (KDE), `Alt+F12` (Emacs), `Alt+F12` (Sublime Text), `⌥ F12` (Sublime Text (macOS)), `Ctrl+Alt+1` (Visual Studio), `⌘ ⌃ 1` (Visual Studio (macOS)), `Alt+F12` (NetBeans), `Alt+F12` (Eclipse), `⌥ F12` (Eclipse (macOS))）中输入：

`npm install standard --save-dev`

了解更多信息，请访问 [JavaScript Standard Style 官方网站](http://standardjs.com/#install)。

Procedure: 通过 ESLint 启用 Standard 检查

如果您打开的项目中  `standard`  被列在项目的  `package.json`  文件中，IntelliJ IDEA 会自动启用 Standard 的 linting。

1. 在   设置   对话框（ `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS))），转到  `语言 & 框架 | JavaScript | 代码质量工具 | ESLint` 。

2. 在打开的   ESLint  页面上，选择   手动 ESLint 配置  并在   ESLint 包  字段中指定  `standard` 包的位置。

Procedure: 将 JavaScript Standard Style 设置为默认

1. 在   设置   对话框（ `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS))），转到  `编辑器 | 代码样式 | JavaScript` 。

2. 在 [JavaScript](settings-code-style-javascript.html)页面上，点击   设置从  ，然后选择   JavaScript Standard Style  。 该样式将替换您当前的方案。

## 使用 Docker 的 ESLint

使用 IntelliJ IDEA，您可以在 Docker 容器内运行 ESLint 来检查代码，与在本地运行的方式相同。

有关更多信息，请参阅 [使用 Docker 运行 Node.js](node-with-docker.html)。

Procedure:

1. 按照 [从 JetBrains Marketplace 安装插件](managing-plugins.html#install_plugin_from_repo)中所述，在   设置 | 插件  页面上安装并启用  Node.js 远程解释器 插件。

2. 请确保  Node.js  和  Docker  所需插件已在   设置 | 插件   页面上启用。 有关更多信息，请参阅 [管理插件](managing-plugins.html)。

3. 下载、安装并配置  Docker ，具体步骤请参见 [Docker](docker.html)主题。

4. [在 Docker 中配置 Node.js 远程解释器](node-with-docker.html#ws_node_docker_configure_interpreter)，或通过 [Docker Compose](node-with-docker-compose.html#ws_node_docker_compose_configure_interpreter)，并在您的项目中 [将其设置为默认](node-with-docker.html#ws_node_docker_manage_dependencies)。 此外，请确保与此远程解释器关联的包管理器已 [设置为项目默认](node-with-docker.html#ws_node_docker_manage_dependencies)。

5. 打开您的  `package.json` ，并确保在  `devDependencies`  部分列出了 ESLint：

```JSON
{
  "name": "node-eslint",
  "version": "0.0.0",
  "private": true,
  "scripts": {
    "start": "node ./bin/www"
  },
  "dependencies": {
    "cookie-parser": "~1.4.4",
    "debug": "~2.6.9",
    "express": "~4.16.1",
    "http-errors": "~1.6.3",
    "morgan": "~1.9.1",
    "pug": "2.0.0-beta11"
  },
  "devDependencies": {
    "@eslint/js": "^9.15.0",
    "eslint": "^9.15.0",
    "globals": "^15.12.0"
  }
}
                
```

6. 在编辑器中的任意位置右键点击，然后从上下文菜单中选择   运行 '<package manager> install'  。

7. 之后，ESLint 的工作方式与您在本地处理代码时相同。 直接在编辑器或   问题   工具窗口中查看检测到的问题的说明，并应用建议的快速修复。

![在 Docker 容器中使用 ESLint](https://resources.jetbrains.com/help/img/idea/2026.3/ws_node_docker_eslint.png)

## See also

### 过程

[JavaScript linter](linters.html)