ESLint 在 VSCode 中自动生效需同时满足四个条件：本地安装 eslint、存在有效配置文件、VSCode 打开项目根目录、状态栏显示 ESLint 已启用；本地安装为硬性前提，全局安装大概率失效。
ESLint 在 VSCode 中不会自动生效，必须同时满足四个条件：本地安装 eslint、存在有效配置文件、VSCode 打开的是项目根目录、状态栏显示 ESLint 已启用。
本地安装 eslint 是硬性前提，全局安装大概率失效
VSCode 的 ESLint 扩展默认只查找 node_modules/.bin/eslint。即使你全局装过 npm install -g eslint，插件也仅在找不到本地版本时才回落使用——而一旦团队成员 Node 版本或 ESLint 小版本不一致（比如 v8.52 vs v8.56），就会出现“别人能标红，你没反应”的情况。
- 始终用本地安装：
npm install eslint --save-dev（或yarn add eslint -D） - 验证是否成功：运行
npx eslint --version，有输出即表示可执行文件已就位 - 若项目用 ESM（
package.json里有"type": "module"），必须用.eslintrc.cjs并以module.exports = {...}导出，否则 Node 会报Cannot use import statement
.eslintrc.* 必须放在正确位置，且不能为空
ESLint 按文件路径向上查找最近的配置文件。把 .eslintrc.js 放进 src/ 目录，那么 index.js（在项目根目录）就完全不受控——它只会找根目录下的配置，找不到就静默跳过。
- 配置文件必须放在项目根目录（即含
package.json的那一层） - 空配置 = 零检查：
{}不会触发任何规则；至少要写extends: ["eslint:recommended"] - 用 React？加
plugin:react/recommended；用 TypeScript？额外装@typescript-eslint/eslint-plugin并在extends里加@typescript-eslint/recommended - 避免在
rules里逐条关规则（如"no-console": "off"），优先用overrides分场景控制，比如只对测试文件禁用
VSCode 必须识别为工作区根目录，状态栏图标是唯一可信信号
打开子文件夹（比如只开了 src/）会导致 ESLint 插件根本读不到根目录的 .eslintrc.* 和 package.json，此时编辑器里一切正常，但状态栏右下角不会显示 ESLint 图标——这是最常被忽略的失效原因。
- 确认 VSCode 窗口标题栏显示的是项目名（不是路径名），或资源管理器顶部显示的是项目根目录名
- 看状态栏右下角：没有图标 = 未加载；显示 “Disabled” = 被手动禁用；显示 ESLint 徽标 + 数字 = 正常运行
- 若显示 “Disabled”，点击它 → 选 “Enable for Workspace”；若仍无效，检查
settings.json是否有"eslint.enable": false被用户级设置覆盖 - 编辑器保存无反应？右键文件 → “ESLint: Fix all auto-fixable Problems”，报错则说明解析器（如
@typescript-eslint/parser）没装或路径不对
与 Prettier 共存时，格式类规则必须由 eslint-config-prettier 关闭
ESLint 默认开启 indent、quotes 等格式规则，Prettier 也管这些——两者同时启用会导致保存时反复修正、光标乱跳、甚至无限循环。这不是配置顺序问题，而是职责必须分离。
- 装
eslint-config-prettier：npm install eslint-config-prettier --save-dev - 在
.eslintrc.*的extends数组末尾加"prettier"（必须放最后，否则会被前面的extends覆盖） - TS 项目额外加
"prettier/@typescript-eslint"，并确保@typescript-eslint/eslint-plugin与 ESLint 主版本兼容（v8.x 对应插件 v6.x，v5.x 会报ESLint couldn't determine the plugin） -
.vscode/settings.json中只需设"editor.codeActionsOnSave": { "source.fixAll.eslint": true }，不要同时开"editor.formatOnSave": true且未指定 formatter，否则 Prettier 可能抢在 ESLint 修复前格式化，造成冲突
最容易被忽略的其实是作用域匹配逻辑：ESLint 不按 VSCode 窗口路径生效，而严格按当前打开文件的磁盘路径向上找配置。哪怕你 99% 的配置都对了，只要一个 test/utils.js 文件的上层目录没配好，它就彻底逃逸检查——这种局部失效很难被发现，只能靠状态栏图标和手动触发修复来交叉验证。
