右下角 ESLint 图标不亮说明插件未启用或路径配置错误，需检查插件是否启用、node_modules/.bin/eslint路径是否正确（优先本地而非全局）、Vue/TS文件是否配置了对应parser及overrides，以及Node版本是否≥18.12。
右下角 ESLint 图标不亮，说明根本没跑起来
很多人配完以为好了，结果编辑器里没报错、也没标红——其实 ESLint 压根没被调用。先看 PhpStorm 窗口右下角状态栏：有没有一个灰色或蓝色的 ESLint 图标？没亮，就等于没生效。
常见原因包括：
- 没启用 ESLint 插件：进入
Settings → Plugins，搜ESLint，确保已勾选启用 -
ESLint package路径写错了：必须指向项目本地的node_modules/.bin/eslint（Windows 是eslint.cmd），不能填全局路径如/usr/local/bin/eslint - 用了 pnpm 或 yarn，
node_modules/.bin/eslint是软链接，PhpStorm 在 Windows 下可能读失败；可临时复制一份真实可执行文件过去，比如cp node_modules/.bin/eslint.cmd ./eslint-local.cmd，然后路径指向这个副本
Vue/TS 文件没检查？查 parser 和 overrides 配置
.vue 或 .ts 文件静默无提示，大概率是 ESLint 没识别到文件类型，或者解析器没对上。即使 JS 文件能标红，TS/Vue 也得单独“认领”。
关键点：
立即学习“PHP免费学习笔记（深入）”；
- 确认
eslint.config.js或.eslintrc.cjs中的parser设为@typescript-eslint/parser，且已安装对应包：npm install -D @typescript-eslint/parser - 在配置中显式声明
overrides规则，比如匹配**/*.ts和**/*.vue，并指定parserOptions.project（TS 项目必需） - PhpStorm 的 Node 解释器版本要 ≥18.12（若用
eslint.config.js扁平化配置），否则直接语法报错，不是插件问题，是 Node 版本太低
Fix on Save 只修缩进，不修引号或未使用变量？规则本身不可修复
勾了 Fix on Save 却只改了空格和换行，其他错误纹丝不动——这不是 PhpStorm 的 bug，是 ESLint 的设计限制。
你接手一个需求时，是不是经常这样："改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续"；这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境（JDK、Spring Boot、ORM、数据库、前端框架），记在
ESLint 的自动修复只覆盖带 fixable: true 标记的规则。像 no-console、no-unused-vars（部分场景）、no-alert 这类属于“提示型”规则，本身不支持 --fix。
能修的典型规则包括：
-
semi（分号） -
quotes（单双引号） -
indent（缩进） -
comma-dangle（尾逗号）
想更激进地修复？别依赖 Fix on Save，改用 package.json 脚本："fix": "eslint . --fix --fix-type problem,layout"，再配合 File Watchers 绑定，但注意这会绕过编辑器实时校验逻辑。
“Cannot find module 'eslint-plugin-react'” 错在哪？cwd 和 resolve 上下文错了
报这个错，90% 不是真没装包，而是 ESLint 启动时找模块的路径错了。它默认从 PhpStorm 自己的工作目录启动，而不是你的项目根目录，所以 require() 找不到本地 node_modules 里的插件。
解决办法很直接：
- 务必勾选
Run eslint from package.json（即用npx eslint方式启动），这样模块解析上下文才对得上package.json的dependencies - 关掉
Automatic configuration file detection，手动指定配置文件路径，比如$ProjectFileDir$/.eslintrc.cjs，避免它误加载父目录或全局配置 - 检查
package.json里是否真有对应插件，比如eslint-plugin-react是否在devDependencies中，而不是只写了dependencies
复杂点在于：同一个项目，命令行 eslint --fix 能跑通，PhpStorm 里却报模块找不到——这时候几乎可以断定是上下文路径没对齐，而不是包没装。
