vscode默认不自动修复eslint错误，核心卡点是：必须使用microsoft官方插件、项目根目录存在有效eslint配置、settings.json中显式配置"editor.codeactionsonsave": {"source.fixall.eslint": true}三者缺一不可。
VSCode 默认不自动修复 ESLint 错误，哪怕装了插件、配了规则，保存文件也没反应——核心卡点就三个：插件必须是 Microsoft 官方版、项目里得有可加载的 ESLint 配置、editor.codeActionsOnSave 必须显式设对，缺一不可。
确认 ESLint 插件是 Microsoft 官方版
第三方同名插件（比如某些带“auto-fix”字样的）不支持 source.fixAll.eslint 语义，也不会读取 eslint.config.js 新格式。打开扩展面板（Ctrl+Shift+X），搜 “ESLint”，只认作者栏写着 “Microsoft” 的那个。安装后重启 VSCode，右下角状态栏应出现 ESLint 图标；若显示 “Disabled”，说明插件没识别到当前文件。
- 检查路径：VSCode 只从**当前工作区根目录**找配置，不会向上递归。monorepo 项目要确保用 VSCode 打开的是含
.eslintrc.js或eslint.config.js的子包目录 - 验证依赖：项目里必须已安装
eslint包（npm install eslint --save-dev），否则插件启动失败，控制台报 “Cannot find module 'eslint’” - 版本要求：若用
eslint.config.js（Flat Config），ESLint 版本需 ≥ 8.50.0，插件也需更新至 2026 年 5 月后的版本
确保 ESLint 配置能被正确加载
VSCode 不会执行 npx eslint --init 生成的交互式配置，它只静态读取配置文件内容。常见加载失败原因不是规则写错，而是语法或路径问题。
-
.eslintrc.js中不能有 Node.js 不支持的语法（如可选链?.、空值合并??），否则加载时报 “Failed to load config” - Vue/TSX 文件默认不被检查：需在配置中显式声明
"eslint.options": { "extensions": [".js", ".ts", ".vue", ".tsx"] } - TSX 文件在 Next.js 项目中常漏配：
eslint.config.js的files字段要加"**/*.client.tsx"和"**/*.server.tsx" - 若用
eslint-plugin-vue，parserOptions.parser必须设为"@typescript-eslint/parser"，旧写法@typescript-eslint/eslint-parser已废弃
settings.json 中必须写这四行才真正生效
图形界面勾选 ESLint: Auto Fix On Save 容易被覆盖或忽略，直接编辑 settings.json 最可靠。以下四行缺一不可，且顺序和拼写必须严格：
{
"editor.codeActionsOnSave": {
"source.fixAll.eslint": true
},
"eslint.validate": ["javascript", "typescript", "vue"],
"eslint.options": {
"extensions": [".js", ".ts", ".vue"]
},
"editor.formatOnSave": false
}
-
"source.fixAll.eslint": true是对象，不是布尔值；写成"source.fixAll": true会触发所有语言服务器修复，可能和 Prettier 冲突 -
eslint.validate必须列出实际用到的语言，漏掉"vue"就不检查<script></script>块 -
"editor.formatOnSave": false是关键：Prettier 若开着，会在 ESLint 前抢跑，导致引号、分号反复打架 - 如需仅对 JS 启用，改用语言特定配置：
"[javascript]": { "editor.codeActionsOnSave": { "source.fixAll.eslint": true } }
哪些错误真能自动修？别指望它改逻辑
ESLint 的 --fix 能力仅限无歧义的语法/格式层问题。打开 ESLint 官网规则页，右上角带 ✅ Fixable 标记的才支持。保存后没反应，先看这条规则是否在可修复列表里。
- 能修的：
semi（分号）、quotes（引号）、indent（缩进）、no-trailing-spaces（行尾空格） - 不能修的：
react-hooks/exhaustive-deps（依赖数组缺项）、vue/multi-word-component-names（组件名不合法）、complexity（圈复杂度超限） - 快速验证：在报错行按
Ctrl+.（Windows/Linux）或Cmd+.（macOS），弹出菜单里有 “Fix ‘xxx’ problem” 才说明当前上下文可修复 - 规则配置写法影响修复：必须是
"semi": ["error", "always"]，写成"semi": "error"在部分旧版本中会禁用修复
最常被忽略的是 editor.formatOnSave 和 eslint.options.extensions 这两行，它们不报错，但会让修复静默失效——现象是 ESLint 能标红，就是不修，查日志也看不到错误，纯靠配置项逐条核对。
