VSCode保存时自动修复ESLint报错依赖本地配置而非网络：需确保eslint.enable为true、editor.codeActionsOnSave正确配置、Vue文件被eslint-plugin-vue和解析器识别、状态栏显示“ESLint”且输出通道无加载错误。
VSCode 保存时自动修复 ESLint 报错，和 Vue 环境是否在线无关 —— 它依赖本地 eslint 包、正确配置的插件与规则，不调用任何远程服务。所谓“离线部署 Vue 环境”不是前提，而是干扰项；真正卡住的，永远是本地配置链路中的某个断点。
为什么装了 ESLint 插件却完全没反应？
最常见原因是 eslint.enable 被设为 false（尤其在工作区设置里被手动关过），或 editor.codeActionsOnSave 根本没配。VSCode 不会报错，也不会提示，它只是静默跳过整个流程。
- 打开 VSCode 设置（
Ctrl+,），搜索eslint.enable，确保值为true - 搜索
codeActionsOnSave，点击右上角“在 settings.json 中编辑”，确认写的是："editor.codeActionsOnSave": { "source.fixAll.eslint": true }而不是"source.fixAll"或拼错成"source.fixall.eslint" - 重启 VSCode —— 配置变更后 ESLint 语言服务器不会热重载，必须重启才生效
Vue 单文件组件（.vue）里 JS/TS 不修复？
Vue 文件默认不被 ESLint 当作 JavaScript 处理，必须靠 eslint-plugin-vue 和显式解析器联动。哪怕 eslint --fix src/App.vue 在终端能跑通，VSCode 仍可能不修，因为插件没识别到该文件类型。
- 检查项目是否安装了
eslint-plugin-vue（Vue 3 项目必须用 v9+） -
.eslintrc.js或eslint.config.js中必须有files: ["**/*.vue"]或overrides显式包含"*.vue" -
parserOptions.parser必须明确指定："@typescript-eslint/parser"（TS + Vue）或"@babel/eslint-parser"（JS + Vue），不能留空或写错成"@typescript-eslint/eslint-parser"（已废弃） - 右下角状态栏看到 “ESLint” 字样才说明当前文件已被激活；没显示就代表匹配失败
保存时卡住、报错但没提示？查输出通道
VSCode 的 ESLint 插件失败时往往不弹窗，只在后台日志里记一笔。你以为它“没反应”，其实它早就报错了，只是你没看。
分析 Vue 3 Composition API 使用情况——审计响应式模式、可组合函数设计、ref 与 reactive 的选择、计算属性、watcher 使用及组件……
立即学习“前端免费学习笔记（深入）”；
- 按
Ctrl+Shift+P打开命令面板，运行ESLint: Show Output Channel - 看输出里有没有
Failed to load config、No ESLint configuration found或Cannot find module 'eslint-plugin-vue' - 同时在终端执行：
npx eslint --ext .js,.ts,.vue src/ --dry-run，验证项目级配置是否可读、规则是否加载成功 - 确认 VSCode 是以项目根目录打开的（不是父文件夹），否则找不到
node_modules/eslint
Next.js / TypeScript / Vue 混合项目里容易漏掉的点
这类项目规则交集多，配置稍有偏差就会导致部分文件失效。比如 .server.tsx 后缀默认不在 ESLint files 列表中，setup 语法里的 vue/multi-word-component-names 规则可能误报且不可修。
-
eslint.config.js中的files必须显式覆盖所有实际用到的后缀：["**/*.js", "**/*.ts", "**/*.vue", "**/*.tsx", "**/*.server.tsx"] - TS + Vue 组合下，
parserOptions.parser必须是"@typescript-eslint/parser"，且overrides中对"*.vue"的配置不能漏掉parser字段 - 某些规则（如
react-hooks/exhaustive-deps）在嵌套或动态依赖场景下无法安全自动修复 —— 这不是配置问题，是 ESLint 本身的限制，得人工处理
真正难调的从来不是“怎么开开关”，而是某一行配置路径写错、某个插件版本不兼容、或某个 glob 模式漏掉了一个星号。这些细节不会报红，只会让修复功能彻底消失。建议每次改完配置，都去 ESLint: Show Output Channel 看一眼日志，比猜半天高效得多。
