.eslintignore仅控制ESLint检查范围，不影响WebStorm文件索引；需确保WebStorm中ESLint已启用、配置文件路径正确，且忽略规则符合glob语法（如src/assets/**），避免路径错误或被files字段绕过。
WebStorm 本身不读 .eslintignore 来决定是否索引文件，但它会尊重该文件来控制 ESLint 的检查范围——也就是说，.eslintignore 只影响「ESLint 报错是否出现」，不影响「文件是否被 WebStorm 加载或搜索」。要真正让某些文件不触发 ESLint 提示，得配对使用 .eslintignore + WebStorm 的 ESLint 插件启用状态。
怎么写 .eslintignore 才生效
.eslintignore 是纯文本文件，放在项目根目录（和 package.json 同级），每行一个匹配模式，支持 glob 语法。它只对 ESLint CLI 和 WebStorm 中启用的 ESLint 检查起作用。
- 忽略整个
src/assets目录：src/assets/** - 忽略所有测试文件：
**/*.test.js或**/__tests__/** - 忽略构建产物：
dist/、build/、.next/ - 注意：路径不能以
/开头（如/src/utils是无效的），也不能带空格或中文通配符
写完后不需要重启 WebStorm，但确保你没在单个文件里写了 /* eslint-disable */ —— 它会覆盖 .eslintignore 的全局设置。
WebStorm 里必须启用 ESLint 才认 .eslintignore
如果 .eslintignore 写对了却还在报错，大概率是 WebStorm 根本没启用 ESLint：
- 进
Settings > Languages & Frameworks > JavaScript > Code Quality Tools > ESLint - 勾选
Enable，并确认Configuration file指向了正确的.eslintrc.js或eslint.config.js - 如果用的是
eslint.config.js（ESLint v9+ 默认格式），确保 WebStorm 版本 ≥ 2024.3；旧版本可能无法识别，会静默失败 - 不推荐选
Automatic configuration——它有时会误判配置位置，尤其在 monorepo 里
为什么加了 .eslintignore 还在报错
常见现象：某文件明明在 .eslintignore 里，编辑器里仍有红色波浪线。原因通常有三个：
-
.eslintignore路径匹配错误（比如写了src/components/，但实际文件在src/pages/components/） - 文件已被 WebStorm 缓存为「已检查」，而 ESLint 不会自动重新评估 ignore 状态；可右键文件 →
Reload from Disk，或执行File > Reload project from disk - 该文件被其他配置显式包含：比如
eslint.config.js里用了files: ["src/**/*.js"]，就可能绕过 ignore 规则；此时需改用ignores字段（v9+）或调整files范围
想彻底禁用某个文件的 ESLint，别只靠 .eslintignore
.eslintignore 是项目级开关，适合批量排除。如果只是临时跳过某个文件（比如自动生成的 API client、mock 数据文件），更直接的方式是：
- 在文件顶部加注释：
/* eslint-disable */ - 或者只关特定规则：
/* eslint-disable no-unused-vars, import/no-unresolved */ - 不想改源码？右键文件 →
Remove from ESLint Scope（WebStorm 2024.1+ 支持，本质是往.idea/jsLinters/eslint.xml里加排除项）
注意：Remove from ESLint Scope 是 WebStorm 特有行为，不会写入 Git，也不影响 CLI 运行结果；而 .eslintignore 是团队共享规则，优先级更高。
真正容易被忽略的一点：WebStorm 的 ESLint 配置和终端里 npx eslint 的行为并不完全一致——它默认只检查打开的文件和当前编辑器中可见的文件，除非你手动开启 Run for whole project。所以即使 .eslintignore 没问题，也可能只是「还没轮到它检查」。
