VS Code 中 ESLint 配置需确保本地安装、存在合法配置文件（如 .eslintrc.cjs 或 eslint.config.js）、设置 root: true、VS Code 启用 eslint.enable 并配置 eslint.validate 支持对应语言，否则将出现无检测、规则不生效等问题。
VS Code 里配 ESLint 不是装个插件就完事，关键得让 eslint 真正读到你的配置、识别项目结构、并和编辑器行为对齐——否则你会看到“no linting detected”、规则不生效、或者报错路径错乱。
确认项目已安装 ESLint 及对应解析器
VS Code 的 ESLint 插件（dbaeumer.vscode-eslint）默认只调用你项目本地的 eslint，不走全局安装。如果没装，插件会静默失效。
- 在项目根目录运行：
npm install eslint --save-dev（或yarn add eslint -D） - 根据代码类型补装解析器：React 项目需
npm install @typescript-eslint/parser @typescript-eslint/eslint-plugin --save-dev；Vue 项目加eslint-plugin-vue - 检查
node_modules/.bin/eslint是否存在，不存在说明安装失败或用了 pnpm/yarn 2+ 的隔离模式，需额外配置"eslint.packageManager"
必须有合法的 ESLint 配置文件
ESLint 启动时会按顺序查找 .eslintrc.js、.eslintrc.cjs、eslint.config.js（v8.50+ 新格式）等。没有它，插件连规则都加载不了。
- 推荐从命令行初始化：
npx eslint --init，按提示选框架/语法/风格，它会自动生成适配的.eslintrc.cjs - 若用
eslint.config.js（扁平化配置），确保导出的是数组，且包含files和rules字段，否则 VS Code 可能无法匹配文件 - 配置中
root: true很重要——防止向上递归到父目录的配置，导致规则冲突
VS Code 设置需显式启用并指定工作区范围
插件默认开启，但容易被用户设置或工作区设置覆盖。常见症状是“保存时不修复”或“仅对 JS 文件生效”。
- 在项目根目录的
.vscode/settings.json中写入：{ "eslint.enable": true, "eslint.run": "onType", "eslint.format.enable": true, "editor.codeActionsOnSave": { "source.fixAll.eslint": true } } - 若项目含多种语言（如 .ts, .vue, .jsx），需在 ESLint 配置里明确
files模式，并在 VS Code 设置中补充："eslint.validate": ["javascript", "typescript", "vue"] - 禁用其他冲突的格式化工具（如 Prettier 的 auto-format）或调整它们的执行顺序，否则
source.fixAll.eslint可能被绕过
调试“规则不触发”或“报错路径错误”的典型路径
这类问题几乎都源于 ESLint 进程启动时的工作目录或解析上下文不对，不是插件坏了。
- 打开 VS Code 输出面板（
Ctrl+Shift+U），选择 “ESLint”，看日志里是否出现Failed to load config或No files matching... - 检查当前打开的文件是否在 ESLint 配置的
files范围内（比如配置只含**/*.js，但你在编辑index.tsx） - 终端进项目根目录手动运行
npx eslint src/App.js，对比输出是否和编辑器一致——如果不一致，说明 VS Code 没正确找到配置或 node_modules - 多根工作区下，ESLint 默认只认第一个文件夹的配置，其余需在各自文件夹内放独立配置或用
eslint.workingDirectories显式声明
最常被跳过的其实是 root: true 和 eslint.validate 扩展语言列表——这两处一漏，整个流程就卡在第一步。别急着查插件版本，先盯住控制台输出里的路径和加载日志。
