vscode保存时自动修复eslint错误需显式配置四行核心设置："editor.codeactionsonsave": {"source.fixall.eslint": true}、"eslint.validate": ["javascript", "typescript", "vue"]、"eslint.options": {"extensions": [".js", ".ts", ".vue"]}、"editor.formatonsave": false；否则即使规则可修复也无响应。
VSCode 默认不会在保存时自动修复 ESLint 错误，必须显式配置 editor.codeActionsOnSave 并确保 ESLint 插件能正确定位项目配置和本地依赖——否则即使规则标着 ✅ Fixable，保存也完全没反应。
必须写进 settings.json 的四行核心配置
图形界面勾选或零散设置容易遗漏或被覆盖，直接编辑工作区或用户级 settings.json 最可靠：
-
"editor.codeActionsOnSave": { "source.fixAll.eslint": true }—— 注意是对象，不是布尔值；别写成"source.fixAll": true，那会触发所有语言服务器的修复逻辑，可能冲突 -
"eslint.validate": ["javascript", "typescript", "vue"]—— 没加"vue"，.vue文件里的<script></script>就不会被检查 -
"eslint.options": { "extensions": [".js", ".ts", ".vue"] }—— 特别是".vue"，ESLint 默认不处理它，必须显式声明 -
"editor.formatOnSave": false—— 关键！否则 Prettier 或其他 formatter 会抢在 ESLint 前格式化，导致引号、分号等规则反复打架
为什么 ESLint 图标不亮 / 输出里报 “No configuration found”
VSCode 不会自动向上查找 .eslintrc.js，它只认当前工作区根目录下的配置文件。常见断点：
- 打开的是父文件夹（比如 monorepo 根），但 ESLint 配置在子包里 —— 改为用 VSCode 打开该子包目录
- 用了
eslint.config.js（Flat Config 新格式），但没装 ESLint v8.50+ 或插件版本 - 项目用 pnpm/yarn，但
eslint.packageManager没设对，比如实际用 pnpm 却设成"npm"—— 插件找不到node_modules/.bin/eslint -
.eslintrc.js里有语法错误（比如多了一个逗号、用了??但 Node 版本太低）—— VSCode 加载失败，控制台报Failed to load config
Vue/TS/Next.js 项目里修复失效的典型原因
不是配置漏了，而是解析器或文件匹配没对上：
-
.vue文件没修：确认eslint-plugin-vue已安装，且parserOptions.parser显式设为"@typescript-eslint/parser"（不是@typescript-eslint/eslint-parser，后者已废弃） - TSX 文件没反应：Next.js 项目需在
eslint.config.js的files字段手动加上"**/*.server.tsx"和"**/*.client.tsx"，默认不包含 - TS 类型相关规则不修：检查
parserOptions.project是否指向正确的tsconfig.json路径，路径错或include没覆盖当前文件，@typescript-eslint就无法推导类型 - 右下角状态栏不显示 “ESLint” —— 说明当前文件根本没被 ESLint 管理，先查
eslint.validate和eslint.options.extensions是否含对应后缀
哪些问题永远修不了，别白等
eslint --fix 只能改语法层面可推导的细节，不是 AI 重构工具：
-
no-console、no-alert、max-lines、complexity—— 这些规则文档里没标 ✅ Fixable，保存时必然跳过 -
vue/multi-word-component-names、react-hooks/exhaustive-deps—— 涉及语义或运行时行为，ESLint 不敢自动改名或补依赖 - 被
// eslint-disable-next-line注释屏蔽的代码块 —— 直接跳过，不提示也不修 - 规则写成
"no-unused-vars": "error"（字符串形式）而非["error", "all"]（数组形式）—— 某些旧版插件会禁用修复能力
真正容易被忽略的是：VSCode 的修复只作用于当前打开的文件，和 CLI 执行 npx eslint . --fix 完全不是一回事；如果想批量清理，还是得回终端跑命令。
