VSCode中ESLint自动修复失效的根本原因是配置未对齐：必须显式设置"editor.codeActionsOnSave": {"source.fixAll.eslint": true}，启用editor.formatOnSave，并确保文件被识别、规则可修复且本地eslint已安装。
VSCode 里 ESLint 报错多、改得烦，根本原因不是规则太严，而是配置没对齐——自动修复没开、文件没被识别、规则本身不可修，三者占其一，你就得手动点右键选“Fix all fixable problems”。
editor.codeActionsOnSave 必须显式配，不是装了插件就自动修
VSCode 默认关闭保存时自动修复，eslint.autoFixOnSave 已在 ESLint 插件 v2.2.0+ 中彻底移除，继续写它毫无作用。真正起效的是 VSCode 自身的通用代码操作机制：
-
"editor.codeActionsOnSave"必须在settings.json（推荐工作区级）中明确定义，不能只靠插件默认值 - 只写
"source.fixAll": true是危险的——它会尝试调用所有启用的 linter（比如 Prettier + ESLint 同时存在时可能冲突报错） - 稳妥写法是：
"source.fixAll.eslint": true，精准限定仅 ESLint 规则参与自动修复 - 还要确认
editor.formatOnSave为true，否则即使规则可修，VSCode 也不会触发格式化流程
.eslintrc.js 或 eslint.config.js 没被读到，ESLint 就等于没启动
插件图标右下角显示 “ESLint” 字样，不代表它真在检查你的文件——可能只是进程起来了，但配置压根没加载成功。常见断点：
- 项目根目录下没有
.eslintrc.js、.eslintrc.cjs、.eslintrc.json，或package.json里没eslintConfig字段；eslint.config.js（ESLint v8.22+ 新格式）需额外设置eslint.experimental.useFlatConfig: true，且插件版本 ≥ 2.4.10 - 运行
npx eslint --print-config src/App.tsx（换为你实际文件路径），看输出是否含预期规则；若报Failed to load config，说明配置路径/语法/依赖缺失 -
.eslintrc.js里用了export default—— Node.js 加载失败，必须用module.exports = { ... } - TypeScript 项目漏了
parserOptions.project（如"./tsconfig.json"），会导致@typescript-eslint/no-unused-vars这类依赖类型信息的规则完全不生效
文件后缀没进 files/overrides，ESLint 直接跳过不处理
Vue 单文件组件、Next.js 的 .server.tsx、TSX 文件，ESLint 默认不认——不是插件问题，是配置里没告诉它“这些文件也要扫”。
前端设计优化skill
下载
前端设计与 UI/UX 全方位优化专家。覆盖视觉层次、排版系统、色彩理论、响应式布局、交互体验、动画动效、无障碍访问、性能优化八大维度，帮助开发者将普通页面升级为高品质产品级界面。前端设计与 UI/UX 全方位优化专家。覆盖视觉层次、排版系统、色彩理论、响应式布局、交互体验、动画动效、无障碍访问、性能优化八大维度，帮助开发者将普通页面升级为高品质产品级界面。
立即学习“前端免费学习笔记（深入）”；
- 检查
.eslintrc.js中的files或overrides字段，确保覆盖了实际使用的后缀：["**/*.js", "**/*.jsx", "**/*.ts", "**/*.tsx", "**/*.vue", "**/*.server.tsx"] - Vue 项目必须装
eslint-plugin-vue，并在plugins和extends中正确引用，否则.vue文件解析失败，报Parsing error: Cannot find module 'xxx' - Next.js App Router 下，
.client.tsx同样需要显式加入files，否则保存时零反应，连波浪线都不会出 - VSCode 右下角语言模式必须是
JavaScript React、TypeScript React或Vue，而不是Plain Text—— 否则 ESLint 根本不挂载
规则标了 ✅ Fixable，但保存后还是不修？先查 CLI 行为
VSCode 看似“没反应”，往往是因为规则在当前上下文不可安全修复，而非配置失效。验证方法很简单：
- 终端进项目根目录，执行
npx eslint --fix src/components/Button.tsx（换你实际文件），观察输出末尾是否有类似1 error and 0 warnings potentially fixable with the `--fix` option - 如果 CLI 能修，VSCode 却不修：大概率是
editor.defaultFormatter没设对——比如 JavaScript 文件的默认格式化工具仍为esbenp.prettier-vscode，需手动改为dbaeumer.vscode-eslint - 如果 CLI 也不修：说明该规则在此处不可修（例如
react-hooks/exhaustive-deps在闭包嵌套过深时放弃自动插入依赖），这不是配置问题，是 ESLint 的保守策略 - 常用可修规则有：
semi、quotes、indent、no-trailing-spaces；不可修的典型是圈复杂度、类型错误、逻辑判断类规则
最常被忽略的一点：VSCode 的 ESLint 插件只读本地 node_modules/.bin/eslint，全局安装的 ESLint 完全无效。哪怕你 npm install -g eslint 装了十遍，只要项目里没 devDependencies 里的 eslint，它就起不来。
