ESLint在PhpStorm中不报错、不标红、不修复，首要原因是未被调用：右下角ESLint图标未亮起；需启用插件、路径指向本地node_modules/.bin/eslint（Windows为eslint.cmd）、手动指定配置文件、检查parser及overrides匹配文件类型。
ESLint 在 PhpStorm 中不报错、不标红、保存也不修复？不是规则没写对，而是它根本没被调用起来——右下角状态栏看不到 ESLint 图标，就等于没启动。
怎么看 ESLint 到底有没有在运行
很多人配完路径、装完插件就以为万事大吉，结果编辑器里 JS 代码写成“天书”也没提示。核心判断依据只有一个：看右下角状态栏是否出现亮起的 ESLint 图标。没亮，说明 PhpStorm 没真正调用 ESLint；亮了但没反应，再查规则或 parser。
- 确保
Settings → Plugins中已启用ESLint插件（不是 “ESLint Support”，那是旧版） - 图标灰色 = 未启用或路径错误；图标常亮 = 已接入，可继续排查规则/配置
- 如果图标偶尔闪一下又消失，大概率是 ESLint 启动失败后被自动禁用，需看 Event Log 里的具体报错
ESLint package 路径必须指向项目本地 node_modules/.bin/eslint
全局安装的 eslint 在 PhpStorm 里极大概率失效，尤其当项目用 pnpm 或 Node 版本混用时。Windows 下还容易因软链接读取失败导致“Cannot find module”。
- 路径填
./node_modules/.bin/eslint（macOS/Linux）或./node_modules/.bin/eslint.cmd（Windows），不能填全局路径如C:\Users\xxx\AppData\Roaming\npm\eslint.cmd - 若用
pnpm且 Windows 下报错，可临时复制node_modules/.bin/eslint.cmd到同目录并重命名为eslint-local.cmd，路径改用这个副本 - 确认项目根目录下存在
package.json，且其中devDependencies包含eslint（版本建议 ≥8.50.0）
Vue/TS 文件不检查？重点核对 parser 和 overrides
.vue 或 .ts 文件静默无提示，90% 是因为 ESLint 没识别文件类型，或者解析器没配对。默认只处理 .js，其他扩展名必须显式声明。
立即学习“PHP免费学习笔记（深入）”；
- 在
.eslintrc.cjs或eslint.config.js中，必须包含overrides块，例如：
overrides: [
{
files: ['*.ts', '*.tsx'],
parser: '@typescript-eslint/parser',
plugins: ['@typescript-eslint'],
},
{
files: ['*.vue'],
processor: 'vue/vue3',
rules: { 'vue/multi-word-component-names': 'off' },
}
]
parser 必须和 plugins 版本匹配：@typescript-eslint/parser ≥6.0 要求 ESLint ≥8.37，否则直接 crasheslint.config.js，确保 PhpStorm 使用的 Node 解释器 ≥18.12（Settings → Languages & Frameworks → Node.js and NPM）Fix on Save 只修缩进，不修引号或未使用变量？这是设计使然
PhpStorm 的 Fix on Save 底层调用的是 eslint --fix，而 ESLint 规则分 fixable 和非 fixable 两类。no-console、no-unused-vars 默认不可自动修复，所以不会动。
- 想让
no-unused-vars可修复，需在配置中显式开启："no-unused-vars": ["error", { "args": "none", "fix": true }] -
semi、quotes、indent这类 layout 类规则天然支持--fix，所以保存时会生效 - 如需更激进修复（比如同时修
problem和layout），不要依赖 Fix on Save，改用File Watchers绑定命令：npx eslint --fix --fix-type problem,layout $FilePath$
最易被忽略的一点：ESLint 配置文件的加载顺序。PhpStorm 不会自动向上查找父目录的 .eslintrc，如果你手动指定了 .eslintrc.cjs 路径，它就不会管项目外的任何配置——哪怕你只是想继承团队基础规则，也得明确 extends 写全路径或包名。
