PhpStorm中ESLint不标红主因是未运行：先确认右下角ESLint图标是否亮起；需启用插件、路径指向项目本地node_modules/.bin/eslint（Windows为eslint.cmd）、勾选“Run eslint from package.json”、手动指定配置文件、匹配Node版本、正确配置parser及files规则。
PhpStorm 里 ESLint 不标红、不提示，八成不是规则写错了，而是它根本没跑起来——先看右下角状态栏有没有亮起的 ESLint 图标。
确认 ESLint 插件已启用且路径指向本地 node_modules/.bin/eslint
很多人配完 .eslintrc.cjs 还是没反应，问题常出在路径上：
- Settings → Languages & Frameworks → JavaScript → Code Quality Tools → ESLint → Node interpreter 和 ESLint package 必须都指向项目级路径，不是全局（比如
/usr/local/bin/eslint或C:\Users\xxx\AppData\Roaming\npm\eslint.cmd） - Windows 下若用 pnpm/yarn，
node_modules/.bin/eslint可能是软链接，PhpStorm 读取失败；可临时复制一份真实可执行文件过去（如把eslint.cmd复制为eslint-local.cmd，再指向它） - 勾选
Run eslint from package.json：这会让 PhpStorm 用npx eslint启动，自动继承package.json的dependencies上下文，避免Cannot find module 'eslint-plugin-react'类错误
手动指定配置文件，别信 “Automatic detection”
PhpStorm 自动探测容易加载父目录或全局的 .eslintrc.js，导致规则错乱：
- 取消勾选
Automatic configuration file detection - 在
Configuration file栏里手动填入绝对路径，例如：$ProjectFileDir$/.eslintrc.cjs或$ProjectFileDir$/eslint.config.js - 若用新式扁平化配置
eslint.config.js，确保 Node 版本 ≥18.12，且 PhpStorm 设置中指定的 Node 解释器版本匹配——旧版 Node 会直接报Unexpected token 'export'，而不是“找不到配置文件”
Fix on Save 只修一部分？检查规则是否支持自动修复
勾了 Fix on Save 却只修缩进、不修引号或未使用变量，不是配置漏了，是 ESLint 本身不支持：
立即学习“PHP免费学习笔记（深入）”；
-
eslint --fix只能修复带fixable: true标记的规则（如quotes、semi、indent），但no-console、react-hooks/exhaustive-deps等规则根本不支持自动修复 - 想更激进地修复，可在
package.json加脚本："fix": "eslint . --fix --fix-type problem,layout"，再通过 File Watchers 绑定；但注意这会绕过编辑器实时校验逻辑，无法即时反馈 - 保存时修复 ≠ 全量修复：它只作用于当前文件变更部分，不会扫描整个项目
JS 和 TS 混合项目要额外装 @typescript-eslint/parser
如果项目含 .ts 或 .tsx 文件，仅靠基础 ESLint 会报语法解析错误：
- 必须安装：
npm install --save-dev @typescript-eslint/parser @typescript-eslint/eslint-plugin typescript - 配置中
parser要设为@typescript-eslint/parser，且plugins加@typescript-eslint - 若用
eslint.config.js新格式，推荐按官方方式导出：import tseslint from 'typescript-eslint'; export default tseslint.config(...)；否则容易因parserOptions.project路径不对，导致类型检查失效
最常被忽略的一点：ESLint 配置生效的前提是文件被识别为 JavaScript/TypeScript —— 确保 .js 和 .ts 文件后缀在 Settings → Editor → File Types 中绑定到了正确的文件类型，否则连语法树都构不起来，更别说检查了。
