VSCode中ESLint自动修复不生效，主因是本地eslint未安装或未被调用、配置文件未识别、规则本身不可修复；需确认npx eslint --version可执行、右下角显示本地路径、settings.json含codeActionsOnSave等四行核心配置，并验证规则带✅Fixable标识。
VSCode 里 ESLint 自动修复不生效，基本不是插件坏了，而是本地 eslint 没被正确调用、配置文件没识别、或规则本身不可修复——三者缺一都会导致“保存没反应”。
确认本地 eslint 包已安装且可执行
ESLint 插件只是个调度器，真正干活的是你项目里的 node_modules/.bin/eslint。装了插件但没装包，等于买了扳手没配螺丝刀。
- 在项目根目录运行
npx eslint --version，必须能输出版本号；报command not found就得先npm install eslint --save-dev - 右下角状态栏点 ESLint 图标，如果显示
Using globally installed ESLint，说明 VSCode 没走本地，要去设置里把eslint.packageManager显式设为npm（或yarn/pnpm） - Monorepo 项目要确认当前打开的是子包根目录，或在子包里单独
npm install，否则插件会向上找配置却找不到本地eslint
检查 settings.json 的核心四行配置
图形界面勾选无效，必须写进 settings.json（推荐放工作区 .vscode/settings.json，避免污染全局）。
-
"editor.codeActionsOnSave": { "source.fixAll.eslint": true }—— 这是自动修复的开关，注意不是source.fixAll（会触发所有 linter，可能崩） -
"eslint.validate": ["javascript", "typescript", "vue", "typescriptreact"]—— 漏掉typescriptreact，.tsx文件就完全不校验 -
"eslint.options": { "extensions": [".js", ".ts", ".jsx", ".tsx", ".vue"] }——.vue必须显式加进去，否则 SFC 里的 script 块直接被跳过 -
"editor.formatOnSave": false—— 关键！否则 Prettier 和 ESLint 同时格式化，引号、分号、空行全乱套
验证配置文件是否被正确加载
VSCode 不会报错说“配置文件没读到”，它只会静默降级为默认规则——所以波浪线看着有，但和你写的 .eslintrc.js 完全无关。
立即学习“前端免费学习笔记（深入）”；
- 按
Ctrl+Shift+P运行ESLint: Show Output Channel，看日志里有没有Using configuration from /path/to/.eslintrc.js - 如果提示
Failed to load config或Cannot find module 'eslint-plugin-react'，说明plugins字段里写的插件没装，运行npm list eslint-plugin-react确认是否在当前node_modules下 - TypeScript 项目必须配
parser: '@typescript-eslint/parser'和parserOptions.project: './tsconfig.json'，否则@typescript-eslint/no-unused-vars这类规则根本不会触发 - 用
eslint.config.js（Flat Config）的话，VSCode 插件需 ≥ v2.4.10，且设置里加"eslint.experimental.useFlatConfig": true，否则直接忽略
哪些规则真能自动修？别指望它改逻辑
eslint --fix 只能修语法层面的“表面问题”，所有涉及语义、结构、意图的，它连碰都不敢碰。
- ✅ 可修：
semi（分号）、quotes（单双引号）、indent（缩进）、no-trailing-spaces（行尾空格）、comma-dangle（尾逗号） - ⚠️ 部分可修：
no-unused-vars能删未用变量，但若变量被注释掉或用于调试，它不敢动 - ❌ 不可修：
react-hooks/exhaustive-deps（依赖数组缺项）、vue/multi-word-component-names（组件名没驼峰）、complexity（圈复杂度超限）——这些必须人工判断 - 查某条规则是否可修，去 ESLint 官网搜规则名，右上角带 ✅
Fixable才算数；比如no-console可删console.log，但替换成toast就不行
最容易被忽略的是：VSCode 默认不扫描 node_modules 和 dist 目录，但如果你在 .eslintrc.js 里写了 files: ['**/*.js'] 却没排除构建产物，ESLint 服务器可能卡住或报错——这种路径控制得靠配置文件本身，而不是 VSCode 设置。
