<p>最可靠方式是在项目根目录创建.eslintignore文件并写入对应路径，如src/utils/legacy.js；或在文件首行添加/ eslint-disable /注释。两者均被ESLint CLI与VSCode插件一致识别，确保工具链统一。</p>
如何在 VSCode 中跳过某个文件的 ESLint 检查
直接禁用单个文件的 ESLint 检查，最可靠的方式是让 ESLint 本身跳过该文件，而不是靠编辑器开关——否则可能影响其他工具链（如 CI 中的 npx eslint）或导致规则不一致。
常见错误现象：只在 VSCode 设置里关掉 eslint.enable，结果整个工作区都失效；或者改了 .eslintignore 却没生效，因为路径没写对或格式不对。
-
.eslintignore必须放在项目根目录（即包含node_modules的那一层），且每行一个 glob 模式，不支持注释 - 路径是相对于
.eslintignore所在位置的，不是相对于当前打开的文件。例如要忽略src/utils/legacy.js，应写src/utils/legacy.js或src/utils/**/legacy.* - 如果用了
eslint.config.js（flat config 格式），.eslintignore仍有效，但不能用ignores字段替代它——ESLint v9 尚未将ignores作为顶层字段支持 - 注意：VSCode 不会自动重载
.eslintignore修改，需手动触发“ESLint: Restart ESLint Server”命令（Ctrl+Shift+P）
为什么 .eslintignore 写了却还在报错
典型原因是 ESLint 没读到这个文件，或者它被更高优先级的配置覆盖了。
使用场景：你加了 dist/** 到 .eslintignore，但 dist/index.js 仍有波浪线；或者你在子包中开发，.eslintignore 放在子目录下完全无效。
- 运行
npx eslint --print-config ./src/utils/legacy.js看输出顶部是否显示Using config from ...和Using ignore file ...—— 如果没显示 ignore 文件路径，说明 ESLint 根本没加载它 -
.eslintignore不支持package.json中的eslintConfig.ignorePatterns写法，后者仅用于 flat config（eslint.config.js）中的ignores数组 - 若项目用了 pnpm/yarn workspaces，确保
.eslintignore在 workspace 根目录，而非某个 package 内部 - Windows 下路径分隔符写
/或\都可以，但不要混用；推荐统一用/，比如build/*.js
临时绕过：在文件顶部加全局禁用注释
这不是推荐做法，但在调试或迁移旧代码时可快速收口。它只对当前文件生效，且 VSCode 和 CLI 行为一致。
容易踩的坑：写成 // eslint-disable 或 // @ts-ignore 完全无效；漏掉空格或大小写错误也会被忽略。
- 必须写在文件第一行（或 BOM 之后、注释之前），格式为：
/* eslint-disable */ - 更安全的写法是限定范围：
/* eslint-disable no-unused-vars, @typescript-eslint/no-explicit-any */ - 注意：该注释对
import/export声明也生效，但不会跳过语法解析错误（如const x = ;） - 和行级禁用不同，它不依赖
eslint.validate设置，只要 ESLint 加载了这个文件就会遵守
复杂点：多语言混合项目中精确控制检测范围
比如 Vue 项目里有 .vue、.ts、.js、.json 多种后缀，但只想对 .ts 和 .vue 开启 ESLint，其他一律跳过。
性能影响：默认情况下 ESLint 会尝试解析所有 eslint.validate 列出的语言，哪怕文件被 .eslintignore 排除——所以必须双保险。
- 在
.vscode/settings.json中显式限制："eslint.validate": ["typescript", "vue"]，去掉javascript可避免对纯.js文件启动检查进程 - 在
eslint.config.js中用files字段精准匹配：{ files: ["**/*.ts", "**/*.vue"], rules: { ... } } - 若用旧版
.eslintrc.cjs，需配合overrides+files，否则rules会全局生效 - 特别注意：VSCode 对
.vue文件的识别依赖右下角语言模式是否为Vue，不是HTML或Plain Text，否则eslint.validate里的vue就不起作用
真正容易被忽略的是：VSCode 的 ESLint 插件不会主动告诉你它到底加载了哪个配置、跳过了哪些文件。遇到“该禁的没禁”，第一反应不该是改设置，而是打开输出面板（View → Output），选 ESLint，看日志里有没有 Skipped file 或 Failed to load config 这类线索。
