VSCode中ESLint插件无反应，首要确认本地已安装ESLint CLI并正确配置路径；其次检查配置文件命名、位置及格式（推荐.eslintrc.cjs）；再确保VSCode继承了shell环境变量或手动指定eslint.runtime；最后按需配置validate、codeActionsOnSave及TypeScript支持。
VSCode 里装 ESLint 插件但没反应？先确认 Node 和 ESLint CLI 是否真可用
插件本身不带 eslint 命令，它只是调用你本地安装的 ESLint。如果打开 JS 文件后没有任何提示、右键也没“Fix all auto-fixable problems”，大概率是 CLI 没装好或路径不对。
检查方法：终端运行 which eslint（macOS/Linux）或 where eslint（Windows），有输出才说明已全局或项目级安装；没输出就别急着配 VSCode。
- 推荐在项目根目录执行
npm install eslint --save-dev，再配.eslintrc.cjs，避免全局污染和版本冲突 - VSCode 默认只认工作区根目录下的
node_modules/.bin/eslint，如果用了 pnpm 或 yarn pnp，得手动设"eslint.packageManager": "pnpm"或指向正确路径 - 某些终端（如 VSCode 内置终端）启动时没加载 shell 配置，
eslint命令存在但不可见，可重启 VSCode 或改用“在外部终端运行”验证
ESLint 插件报 “Cannot find module ‘eslint’” 错误
这是最常被忽略的路径问题——VSCode 启动时没继承到你的 shell 环境变量，尤其 macOS 上用 zsh 但 VSCode 是从 Dock 启动的，压根没读 ~/.zshrc。
- Mac 用户：用
code --new-window从终端启动 VSCode，确保环境一致 - Windows 用户：检查是否混用 PowerShell 和 CMD，插件可能只识别其中一种的
PATH - 通用方案：在 VSCode 设置里搜
eslint.runtime，手动指定node路径（比如/usr/local/bin/node或C:\Program Files\nodejs\node.exe） - 若用 NVM，确保 VSCode 启动前已
nvm use切换到对应版本，否则插件可能调用系统自带老版 Node
配置文件写好了，但规则不生效（比如 no-console 不报错）
ESLint 会按就近原则找配置文件，但只认特定名称和位置。常见失效原因是文件名拼错、放错地方，或用了不兼容的导出格式。
- 优先用
.eslintrc.cjs（CommonJS），比.eslintrc.js更稳妥，避免 ESM 导致的__dirname报错 - 确保文件放在项目根目录，且不在
node_modules、dist这类被默认忽略的文件夹里 - 检查
env和parserOptions.ecmaVersion是否匹配代码语法，比如用了?.却设了ecmaVersion: 5，整个配置会静默失败 - VSCode 的 ESLint 插件默认不校验
.vue或.ts文件，需显式加"eslint.validate": ["javascript", "typescript", "vue"]
想让 ESLint 自动修复保存时的问题，但部分规则修不了
eslint --fix 只能处理带 fixable: true 标记的规则（比如 semi、quotes），像 no-unused-vars 或 complexity 这类逻辑型规则无法自动修，强行设保存即修只会漏掉提示。
- 在 VSCode 设置里开启
"editor.codeActionsOnSave": { "source.fixAll.eslint": true }即可 - 但建议加个例外：
"source.fixAll.eslint": false+ 单独开"source.fixAll": true，避免和 Prettier 冲突 - 如果用了 TypeScript，确保装了
@typescript-eslint/eslint-plugin并在配置中启用，否则no-unused-vars对 TS 类型声明无效 - 保存即修对大型文件可能卡顿，可在设置里加
"eslint.run": "onType"改为输入时校验
真正麻烦的是跨文件作用域类规则（比如 import/no-unresolved），它们依赖完整的项目解析上下文，VSCode 插件有时拿不到，这时候得靠命令行 npx eslint . --ext .js,.ts 兜底。
