ESLint未正确配置或启用规则集会导致JavaScript项目代码风格不统一；需安装官方插件、初始化项目级配置文件、设置保存时自动修复、使用共享配置包、并支持注释禁用特定检查。
如果您在使用 VSCode 编辑 JavaScript 项目时发现代码缩进、分号、引号风格不统一，且缺乏实时语法与风格校验，则很可能是 ESLint 插件未正确配置或未启用规则集。以下是实现代码风格一致性的多种配置与应用方式：
本文运行环境：MacBook Air，macOS Sequoia。
一、安装并启用 ESLint 插件
VSCode 本身不内置 ESLint 功能，需通过官方插件提供语法高亮、实时提示及自动修复支持。启用该插件是后续所有风格控制的前提。
1、打开 VSCode，点击左侧活动栏的扩展图标（或按快捷键 Cmd+Shift+X）。
立即学习“Java免费学习笔记（深入）”；
2、在搜索框中输入 ESLint，找到由 Microsoft 发布的官方插件。
3、点击“安装”，安装完成后点击“重新加载”使插件生效。
二、初始化项目级 ESLint 配置文件
ESLint 的规则必须依托于配置文件（如 .eslintrc.js 或 .eslintrc.json）才能作用于项目。本地配置优先级高于全局设置，确保团队协作中风格可复现。
1、在项目根目录下打开终端，执行命令：npm init @eslint/config（需已安装 Node.js 与 npm）。
2、按交互式提示选择：模块类型（JavaScript modules (import/export)）、框架（None of these）、是否使用 TypeScript（No）、代码运行环境（Browser 和 Node 可多选）、风格偏好（Popular style guide，如 Airbnb 或 Standard）。
3、确认后自动生成 .eslintrc.js 并安装对应依赖包。
三、配置 VSCode 自动修复保存时的问题
仅显示错误不足以提升效率，需让编辑器在保存文件时自动应用修复规则，从而强制统一风格。该功能依赖 VSCode 的格式化设置与 ESLint 插件协同工作。
1、按下 Cmd+, 打开设置界面，在右上角点击“打开 settings.json”图标。
2、在 settings.json 中添加以下内容：
3、插入配置项："editor.codeActionsOnSave": {"source.fixAll.eslint": true}。
4、确保同时存在："eslint.validate": ["javascript", "javascriptreact"]。
四、使用共享配置包统一团队规则
手动维护规则易出错且难以同步，采用社区成熟配置包（如 eslint-config-standard 或 @typescript-eslint/recommended）可降低维护成本，并保障跨成员一致性。
1、在项目中运行：npm install eslint-config-standard --save-dev。
2、打开 .eslintrc.js，将 extends 字段修改为：["standard"]。
3、若项目含 React，额外安装：npm install eslint-plugin-react --save-dev，并在 extends 中加入 "standard-react"。
五、禁用特定行或文件的 ESLint 检查
某些场景下需临时绕过规则（如第三方代码片段、生成代码、兼容性写法），可通过注释指令实现精准控制，避免破坏整体配置的严谨性。
1、在某一行顶部添加：// eslint-disable-next-line no-console，跳过下一行的 console 警告。
2、在某行末尾添加：// eslint-disable-line no-unused-vars，仅忽略当前行的未使用变量提示。
3、在文件顶部添加：/* eslint-disable */，关闭整个文件的检查；添加 /* eslint-enable */ 可恢复后续检查。
