webstorm原生集成eslint，无需安装插件；必须本地安装eslint、使用eslint.config.js（v9+要求export default数组格式）、为.vue/.ts绑定文件类型并重载项目。
WebStorm 本身不依赖“ESLint 插件”来启用 ESLint 功能——它原生集成 ESLint，所谓“安装插件”其实是混淆了概念。真正要做的，是让 WebStorm 正确加载你项目里的 ESLint 实例和配置，否则即使界面显示“已启用”，也完全不报错、不标红、右键没有 Fix ESLint Problems。
为什么装了 ESLint 插件也没用
WebStorm 的 Settings → Plugins 里搜到的 “ESLint” 插件（如某些第三方维护的旧版）基本是冗余甚至冲突的。2026 年当前版本（2026.2 及以上）已内置完整 ESLint 支持，手动装插件反而可能导致：
- 覆盖原生 ESLint 集成逻辑，导致配置项消失或失效
- 与项目本地
eslint版本不兼容（尤其 v9+ 的 flat config） - 干扰 File Watcher 或快捷键绑定，出现“点了没反应”
正确做法：**不装任何 ESLint 相关插件**，直接走 Settings → Languages & Frameworks → JavaScript → Code Quality Tools → ESLint 配置路径。
必须本地安装 eslint，不能全局
WebStorm 只认项目根目录下的 node_modules/eslint（不是 node_modules/.bin/eslint，也不是全局 npm install -g eslint）。常见失败现象：
- 配置页面提示 “Cannot find ESLint package”
- 勾选 Enable 后，下方 Configuration file 下拉为空或灰色不可选
验证方式（终端执行）：
ls node_modules/eslint
若无输出，立刻安装：
npm install --save-dev eslint@latest
或（pnpm 用户）：
pnpm add -D eslint@latest
注意：Vue/TS 项目还需额外安装对应解析器和插件，例如 @typescript-eslint/parser、eslint-plugin-vue，否则 .vue 和 .ts 文件压根不进 ESLint 流程。
配置文件名和导出格式必须严格匹配 ESLint v9+
你用的是 eslint.config.js 还是 .eslintrc.js？这是最常踩的坑。ESLint v9+（2026 年主流）**完全不识别 .eslintrc.* 系列文件**，只接受：
-
eslint.config.js（推荐，导出数组） -
eslint.config.mjs或eslint.config.cjs -
eslint.config.ts（需开启unstable_ts_config标志）
且 eslint.config.js 必须是：
export default [
{
files: ["**/*.js"],
rules: { "no-console": "warn" }
}
]
不是 module.exports = {...}，也不是 export const config = [...]。写错格式，WebStorm 就当配置不存在。
Vue/TS 文件不检查？缺三样东西
WebStorm 默认只对 .js 和 .jsx 启用 ESLint。要让 .vue 里的 <script></script> 块或 .ts 文件生效，必须同时满足：
- 已安装对应依赖：
yarn add --dev eslint-plugin-vue或yarn add --dev @typescript-eslint/parser @typescript-eslint/eslint-plugin -
eslint.config.js中有plugins: ['vue']或plugins: ['@typescript-eslint']，并正确extends对应规则集 - Settings → Editor → File Types → 搜索 “Vue”，确认
*.vue已绑定到Vue.js文件类型（否则 WebStorm 当纯文本处理，跳过 JS 解析）
改完这三项后，务必右键项目 → Reload project from disk，缓存不刷新，配置静默失效。
