ESLint 在 VSCode 中需安装官方扩展、初始化项目配置文件、启用工作区设置、解决路径与加载问题，并配置保存自动修复。具体包括：一、安装 Microsoft 官方 ESLint 扩展并重启；二、运行 npm init @eslint/config 生成 .eslintrc.js；三、在 settings.json 中启用 eslint.enable 并设置 eslint.validate；四、配置 eslint.packageManager 和 eslint.runtime，通过 ESLint: Show Output Channel 验证；五、开启 editor.formatOnSave 并设默认格式化工具为 ESLint，确保规则可修复。
如果您在使用 VSCode 编辑 JavaScript 项目时发现代码风格不一致、潜在错误未被及时提示，或团队协作中难以统一编码标准，则可能是 ESLint 未正确集成或配置失效。以下是确保 VSCode 中 ESLint 插件有效运行并切实保障 JavaScript 代码质量的多种操作路径：
本文运行环境：MacBook Pro，macOS Sequoia。
一、安装并启用 ESLint 扩展
ESLint 功能依赖于 VSCode 官方扩展市场中的 ESLint 插件，该插件负责将本地 ESLint 引擎的校验结果实时渲染到编辑器中，包括高亮、悬停提示和自动修复建议。
1、打开 VSCode，点击左侧活动栏的扩展图标（四个方块组成的图标）。
立即学习“Java免费学习笔记（深入）”；
2、在扩展搜索框中输入 ESLint，找到由 Microsoft 发布的官方扩展。
3、点击“安装”按钮，安装完成后点击“重新加载”以激活插件。
二、初始化项目级 ESLint 配置文件
ESLint 插件默认不自带规则集，必须通过项目根目录下的配置文件（如 .eslintrc.js 或 .eslintrc.json）声明检查规则、环境与解析器，否则插件无法执行任何校验逻辑。
1、在终端中进入项目根目录，运行命令：npm init @eslint/config（需已安装 Node.js 和 npm）。
2、按交互式提示选择 JavaScript modules (import/export)、React（若适用）、TypeScript（若适用），并指定代码风格偏好（如 Airbnb 或 Standard）。
3、确认生成配置文件后，检查项目根目录是否出现 .eslintrc.js 或类似命名的配置文件。
三、配置 VSCode 工作区设置启用 ESLint
即使插件已安装且配置文件存在，VSCode 仍可能因工作区设置未开启而忽略 ESLint 校验；需显式启用其诊断功能并绑定 JavaScript/TypeScript 文件类型。
1、按下 Cmd + ,（macOS）打开设置界面，切换至“工作区”选项卡。
2、在搜索框中输入 eslint.enable，勾选对应复选框以启用 ESLint。
3、继续搜索 eslint.validate，点击“编辑 in settings.json”，将值设为：["javascript", "javascriptreact", "typescript", "typescriptreact"]。
四、解决 ESLint 不报错或规则不生效的问题
常见失效原因为本地 ESLint 未被插件识别、配置文件路径错误或规则被覆盖；可通过强制指定 ESLint 可执行路径及验证配置加载状态来定位问题。
1、在 VSCode 设置中搜索 eslint.packageManager，将其设为 npm 或 yarn，与项目实际包管理器一致。
2、搜索 eslint.runtime，若项目使用 Node.js 18+，可指定为 /usr/local/bin/node（macOS 全局路径，需根据 which node 输出调整）。
3、在 VSCode 命令面板（Cmd + Shift + P）中输入并执行 ESLint: Show Output Channel，查看控制台输出是否成功加载配置文件及规则。
五、启用保存时自动修复 ESLint 错误
自动修复可大幅减少手动修正耗时，尤其适用于格式类警告（如分号缺失、引号风格等），需在 VSCode 设置中启用格式化提供程序并绑定 ESLint。
1、打开设置，搜索 editor.formatOnSave，启用该选项。
2、搜索 editor.defaultFormatter，点击“在 settings.json 中编辑”，添加键值对："javascript": "dbaeumer.vscode-eslint" 和 "typescript": "dbaeumer.vscode-eslint"。
3、确保 ESLint 配置文件中对应规则设置为 "fixable" 类型（如 "semi": ["error", "always"]），否则保存时不会触发修复。
