VSCode中ESLint需本地安装、正确配置parser及插件、设置验证语言和自动修复，并排查配置路径、文件范围与环境兼容性问题。
VSCode 里配 ESLint 不是装个插件就完事，关键得让编辑器真正读到你的规则、识别项目结构、并和你用的 JavaScript/TypeScript 版本对齐。否则你会看到 ESLint: Cannot find module 'eslint-plugin-react' 或者修改代码后毫无反应。
确认项目已安装 ESLint 及对应插件
VSCode 的 ESLint 插件（dbaeumer.vscode-eslint）只是“显示器”，真正干活的是你项目本地的 eslint 包。全局安装的 ESLint 基本无效，尤其在多项目、多 Node 版本环境下。
- 运行
npm install eslint --save-dev（或yarn add eslint -D），确保node_modules/.bin/eslint存在 - 按需安装插件，比如 React 项目要加
eslint-plugin-react，TypeScript 项目必须有@typescript-eslint/eslint-plugin和@typescript-eslint/parser - 检查
package.json中的devDependencies是否包含这些包，缺失会导致“找不到 plugin”错误
配置 .eslintrc.* 文件并指定 parser
ESLint 默认只认 JS，遇到 .ts 或 .jsx 文件会直接跳过——除非你在配置里明确告诉它怎么解析。
- 推荐使用
.eslintrc.js（比 JSON 更灵活，支持注释和条件判断） - TypeScript 项目必须设置
parser: '@typescript-eslint/parser'，且parserOptions.project指向tsconfig.json路径（否则类型相关规则如@typescript-eslint/no-explicit-any不生效） - React 项目需启用
ecmaFeatures.jsx: true并加入plugins: ['react', 'react-hooks'] - 避免把
env设成browser: true后又在 Node 脚本里用require——ESLint 会报require is not defined
在 VSCode 设置中启用自动修复与作用域控制
VSCode 默认不会自动修复，也不区分文件类型——比如你不希望 ESLint 去检查 node_modules 或构建产物，但默认它可能照扫不误。
- 在
settings.json中添加："eslint.validate": ["javascript", "javascriptreact", "typescript", "typescriptreact"]
，漏掉typescriptreact就无法校验.tsx文件 - 开启保存时修复：
"editor.codeActionsOnSave": {"source.fixAll.eslint": true}，但注意：这仅触发“可自动修复”的规则（如分号、引号），缩进或复杂逻辑问题仍需手动处理 - 用
"eslint.options": {"overrideConfigFile": "./.eslintrc.js"}显式指定配置路径，防止工作区嵌套时加载错配置 - 通过
"eslint.workingDirectories"支持 monorepo，例如："eslint.workingDirectories": [{"mode": "auto"}]让 ESLint 自动向上查找每个子包的.eslintrc
排查常见“没反应”场景
代码改了但红波浪线不出现，或者右键“Fix all auto-fixable problems”点完没变化——大概率不是插件坏了，而是环境链断了。
- 打开命令面板（
Ctrl+Shift+P），运行ESLint: Show Output Channel，看输出里是否报Failed to load config或Cannot read property 'rules' of undefined - 检查当前打开的文件是否在 ESLint 配置的
files或ignorePatterns范围内（比如.eslintignore里写了src/**/*.test.js，那测试文件就不会被检查） - 如果用了 PnP（Yarn Berry）或 pnpm，需额外配置
"eslint.packageManager": "pnpm"或手动指定"eslint.runtime"路径 - TSX 文件报
Parsing error: Cannot use JSX unless the '--jsx' flag is provided？说明parserOptions.project没指向含"jsx": "preserve"的tsconfig.json
最常被忽略的一点：VSCode 的 ESLint 插件不会自动监听 .eslintrc 文件变更，改完配置必须重启 VSCode 窗口（或至少重新打开文件），否则旧规则还在内存里跑。
