PhpStorm中ESLint不生效的主因是未正确调用：先确认右下角ESLint图标是否亮起；路径须指向项目本地node_modules/.bin/eslint（Windows为eslint.cmd）；启用插件、勾选“Run eslint from package.json”、手动指定配置文件、匹配Node版本、正确配置parser及files规则。
PhpStorm 里 ESLint 不生效？先确认它真在运行
很多人的 ESLint 看似配好了，但编辑器里没标红、没提示，根本不是配置问题，而是 ESLint 根本没被 PhpStorm 调用。关键看右下角状态栏有没有 ESLint 图标亮起；没亮，说明插件没启用或路径没对上。
- 确保已安装并启用
ESLint插件（Settings → Plugins → 搜 ESLint，勾选） -
ESLint package路径必须指向项目本地的node_modules/.bin/eslint（Windows 是eslint.cmd），不是全局安装路径——全局路径常因 Node 版本或权限失效 - 如果项目用 pnpm/yarn，
node_modules/.bin下的eslint可能是软链接，PhpStorm 在某些 Windows 环境下读取失败，可临时复制一份真实可执行文件过去
“Cannot find module” 错误怎么修？重点查 resolve 和 cwd
常见报错：Error: Cannot find module 'eslint-plugin-react' 或类似插件找不到，本质是 ESLint 启动时的模块解析上下文错了，不是缺包，而是没在对的地方找。
- 在 PhpStorm 的 ESLint 设置中，务必勾选
Run eslint from package.json（即用npx eslint方式启动），否则它会忽略package.json的dependencies上下文 - 不勾选
Automatic configuration file detection，手动指定.eslintrc.cjs或eslint.config.js路径，避免它错误加载父目录配置 - 如果用了
eslint.config.js（新扁平化配置），确保 Node 版本 ≥18.12，且 PhpStorm 使用的 Node 解释器版本匹配——旧版 Node 会直接报语法错误，而非模块缺失
保存时自动修复（Fix on Save）为什么只修一半？
勾了 Fix on save 却只修缩进、不修引号或未使用变量，是因为 ESLint 默认只修复带 fixable 标记的规则，而部分规则（如 no-console）根本不可自动修复。
- 检查你用的配置是否启用了
--fix-friendly 规则：比如quotes、semi、indent都支持，但react-hooks/exhaustive-deps不支持 - PhpStorm 的 Fix on Save 实际调用的是
eslint --fix，它不会运行eslint --fix-type problem这类细粒度控制，所以别指望它按 warning/error 分级修复 - 若想更激进地修复，可在
package.json中加 script："fix": "eslint . --fix --fix-type problem,layout"，然后用 PhpStorm 的 File Watchers 手动绑定——但注意这会绕过编辑器实时校验逻辑
Vue/TS 文件不被检查？检查 parser 和 overrides
JS 文件有提示，但 .vue 或 .ts 里完全静音，大概率是 ESLint 没识别到文件类型，或者 parser 没配对。
立即学习“PHP免费学习笔记（深入）”；
- 确认
eslint.config.js中files匹配到了**/*.vue和**/*.ts，且对应languageOptions.parser指向@typescript-eslint/parser（TS）或vue-eslint-parser（Vue） - Vue 单文件需额外配置
processor: 'vue/vue3-ssr'或'vue/vue3'（取决于 Vue 版本），否则 template 和 script 块全被跳过 - TypeScript 项目若用了
isolatedModules: true，确保@typescript-eslint/parser的project选项指向正确的tsconfig.json，否则类型相关规则（如@typescript-eslint/no-unused-vars）会静默失效
最常被忽略的一点：PhpStorm 的 ESLint 集成不读取 eslintignore 的通配符逻辑（比如 **/dist/**），它只认完整路径匹配。如果你在 eslintignore 里写了相对路径，而 PhpStorm 的工作目录设成了父级，就可能误判文件是否该被忽略。
