VSCode怎么配置ESLint忽略文件_VSCode如何设置eslintignore排除文件【攻略】-VSCode-PHP中文网

.eslintignore 文件对 VSCode 编辑器内 ESLint 检查完全无效，它仅影响命令行 eslint 执行；VSCode 依赖 eslint.validate 设置、配置文件作用域及 overrides 排除规则来控制检查范围。

vscode怎么配置eslint忽略文件_vscode如何设置eslintignore排除文件【攻略】

为什么 `.eslintignore` 文件写了却没用？

VSCode 的 ESLint 扩展本身不读取 .eslintignore 来控制编辑器内的实时检查——它只在命令行运行 eslint 时生效。编辑器里是否检查某个文件，取决于两个更底层的机制：文件是否被 VSCode 的 ESLint 插件“识别为待校验文件”，以及 当前打开的文件路径是否匹配配置文件作用域。

.eslintignore 只影响 CLI 命令（如 npx eslint . 或 CI 流程），对 VSCode 编辑器内高亮、悬停提示、保存修复完全无效
VSCode 实际靠 "eslint.validate" 设置决定哪些语言/后缀的文件启用检查，比如默认不校验 .md、.json 或 node_modules 下的文件
若你把 .eslintignore 放在 src/ 目录下，它对项目根目录的 index.js 也不起作用——ESLint 不按工作区根路径找 ignore，而是按每个文件自身路径向上查找最近的 .eslintignore

VSCode 里真正能“忽略文件”的三种方式

想让某个文件或目录在编辑器中彻底不触发 ESLint 提示，得从 VSCode 自身设置或 ESLint 配置逻辑入手：

方法一：用 "search.exclude" 隐藏（仅限搜索） —— 这不是 ESLint 忽略，只是不让搜索结果出现，不影响语法检查。适用于 dist/、build/ 等生成目录：
```
{ "search.exclude": { "**/dist": true, "**/coverage": true } }
```
方法二：修改 "eslint.validate" 关闭特定语言支持 —— 比如不想检查 Markdown 中的 JS 片段，就删掉 "markdown"；或者禁用对 .vue 的检查（不推荐，但可行）：
```
"eslint.validate": ["javascript", "typescript"]
```
方法三：在 .eslintrc.* 中用 overrides + files 显式排除 —— 最精准的方式，例如跳过所有测试文件的规则校验：
```
overrides: [{ files: ["**/*.test.js", "**/*.spec.js"], rules: {} }]
```

`node_modules` 和 `dist` 为啥默认不报错？

这不是因为 VSCode 主动“忽略”，而是 ESLint 插件内置了安全策略：它会自动跳过 node_modules、dist、build、.git 等常见路径下的文件，哪怕你没配任何 ignore 规则。这个行为由插件自身控制，无法通过用户配置关闭（也不建议关）。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

例外情况：如果你在 src/ 里手动写了 import xxx from 'node_modules/some-lib'，且该模块含可执行 JS，ESLint 仍可能尝试解析它——此时真正起作用的是 "eslint.options" → "resolvePluginsRelativeTo" 或 parserOptions.project 范围限制
若你在 dist/ 下意外看到 ESLint 报错，大概率是 VSCode 当前工作区没开对根目录（比如打开了 dist/ 子文件夹），导致插件找不到项目级 .eslintrc.*，退而使用默认宽松规则

Vue 项目中 template 或 style 区块被误检怎么办？

Vetur（Vue 官方推荐插件）和 ESLint 默认不协同处理 <template></template> 和 <style></style> 内容。如果你看到类似 Unknown word 或 Parsing error: Unexpected token 的报错，基本说明 ESLint 正在错误地尝试解析 HTML 或 CSS。

确认 "eslint.validate" 中没有把 "html" 或 "css" 加进去（它只应包含 "javascript"、"vue" 等）
确保 .eslintrc.js 中正确设置了 parser: 'vue-eslint-parser'，且 parserOptions.parser 指向 @typescript-eslint/parser 或 babel-eslint（针对 <script></script>）
不要给 vetur.validation.template 开启 ESLint 校验（Vetur 自己的模板校验和 ESLint 是两套体系，混用必出错）