ESLint插件未生效导致VSCode报错但代码可运行，需确认插件已安装、激活并正确配置：检查扩展面板、状态栏图标、重启服务；验证配置文件路径与格式；多包项目需设置workingDirectories；确保本地安装eslint、版本兼容；排查语言服务器与编辑器解析不一致问题。
ESLint插件没启用或没装对
VSCode里显示ESLint报错，但代码实际能跑，大概率是插件压根没生效。不是装了就自动管用，得确认它真在当前工作区激活了。
- 打开扩展面板（
Ctrl+Shift+X），搜ESLint，确保安装的是官方那个dbaeumer.vscode-eslint - 右下角状态栏看有没有
ESLint图标；没有？点开命令面板（Ctrl+Shift+P），运行ESLint: Restart ESLint Server - 如果项目根目录有
.eslintrc.js或eslint.config.js，但VSCode没识别，检查文件是否被.vscode/settings.json里的eslint.workingDirectories错误排除了
配置文件路径或格式不被识别
VSCode的ESLint默认只读项目根目录下的配置，遇到多包项目（比如 packages/foo）或新版 eslint.config.js（ESLint v8.50+ 的扁平化配置），容易静默失败。
- 老项目用
.eslintrc.js没问题；新项目推荐用eslint.config.js，但必须确保 VSCode 插件版本 ≥ 2.4.10 - 单仓库多子包时，在
.vscode/settings.json加上："eslint.workingDirectories": ["./", "./packages/*"]
- 如果报错
Failed to load config "eslint:recommended" to extend from，说明 Node.js 环境或本地eslint包没装对——别用全局npm install -g eslint，必须在项目里npm install eslint --save-dev
报错但代码没红波浪线，或波浪线位置错乱
这是语言服务器（Language Server）和编辑器解析范围不一致导致的，尤其常见于 TypeScript + ESLint 混合项目。
- 确认
typescript-eslint版本和 ESLint 版本兼容：v7.x 的@typescript-eslint/parser不支持 ESLint v9，会直接跳过校验 - 在
eslint.config.js中显式指定files和languageOptions.parserOptions.project，否则 TS 类型检查不触发 - 关掉
javascript.validate.enable（VSCode 自带 JS 校验），避免和 ESLint 冲突；设置为false即可
想忽略某行或某文件但不起作用
// eslint-disable-next-line 这类注释失效，通常不是语法写错，而是规则根本没加载进来，或者被配置里的 overrides 覆盖了。
- 优先用
// eslint-disable-next-line rule-name，而不是笼统的// eslint-disable-next-line，否则可能被规则集拒绝 - 忽略整个文件，加
/* eslint-disable */在顶部；但注意：如果该文件匹配了overrides里某个files模式，而那个模式里没配rules，禁用注释就无效 - 临时关闭某条规则，别改配置文件，直接在设置里搜
eslint.rules，加一条用户级覆盖（仅当前工作区）："eslint.rules": { "no-console": "off" }
ESLint 报错看起来是语法问题，实际八成卡在环境链路上：Node 版本、插件版本、配置加载路径、语言服务注册顺序——任何一个环节断了，VSCode 就只能“假装看见”错误。调试时先看输出面板里 ESLint 那个通道的日志，比盯着波浪线猜快得多。
